InitDriversType method |
|
Remarks
Initializes the type of drivers (DirectSound and/or ASIO) for input devices managed by the control. This method can be called only once and will affect any other instance of the control inside the application. Next calls to this method will be ignored until the multimedia engine has been reset through the ResetEngine method: in this specific case the InitDriversType method must be called after the ResetEngine method but before the ResetControl method.
The call to this method must be performed before calling any other method that will use a recording related functionality, possibly in the container form initialization function: calling this method inside the constructor function of the container form will not work and could cause unpredictable results.
IMPORTANT NOTE: When using the Active Sound Recorder control in conjunction with our Active DJ Studio control, which also contains the InitDriversType method, it should be preferred calling the InitDriversType method from Active DJ Studio so it will automatically affect both input and output devices.
If only DirectSound output devices are needed, a call to this method can be omitted; if ASIO input devices are needed, this method should be called before any other method of the control because it will affect input devices enumeration performed through GetInputDevicesCount and GetInputDeviceDesc methods.
For further information about ASIO drivers management, refer to the How to manage ASIO drivers tutorial.
Syntax
[Visual Basic] control.InitDriversType ( nDriverType as enumDriverTypes ) as enumErrorCodes |
[C++] short control.InitDriversType ( short nDriverType ); |
Parameter |
Description |
||||||||||||||||||
|
|
||||||||||||||||||
nDriverType |
Type of drivers managed by the control. Supported values are the following:
|
Return value
Value |
Meaning |
|
|
Negative value |
An error occurred, check the LastError property value in order to get the error code |
enumErrorCodes.ERR_NOERROR (0) |
The method call was successful |