Methods > Init and info > InitDriversType method

Remarks

Initializes the type of drivers (DirectSound or WASAPI) for devices managed by the control. This method can be called only once and will affect any other instance of the control inside the application. If the control should be used in conjunction with the Active DJ Studio control or with the Active Sound Recorder control, these ones would be affected too.

The call to this method must be performed before calling any other method that will access the component, 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.

For further details about the use of WASAPI see the How to manage audio flow through WASAPI 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:

Mnemonic constant	Value	Meaning
DRIVER_TYPE_DIRECT_SOUND (default)	0	Only DirectSound devices are supported and ASIO devices will be ignored.
DRIVER_TYPE_WASAPI	4	Only WASAPI devices are supported: this setting can be only applied under Windows Vista and later versions.

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