|
ASIO.DeviceListenInputStart method |
  
|
|
ASIO.DeviceListenInputStart method |
|
Remarks
Starts the given ASIO device in order to allow direct playback of audio data incoming from one or more input channels to one or more output channels.
In order to allow the call to this method, the ASIO device must be in stopped state.
A started device can be stopped at any time through the ASIO.DeviceStop method.
You can know if a certain device is started or stopped through the ASIO.DeviceIsStarted method.
In this case direct playback is not performed through the stream mixer described inside the How to manage ASIO drivers tutorial as incoming audio data is rendered to the output channel(s) directly but you can still apply special effects to rendered audio data by obtaining the index of the involved internal player through the ASIO.DeviceListenInputPlayerGet method and by using the returned index with any of the methods of the Effects COM object or with the StreamVolumeLevelSet method.
For further details about the use of ASIO drivers see the ASIO object section and the How to manage ASIO drivers tutorial.
Syntax
[Visual Basic] control.ASIO.DeviceListenInputStart ( nDeviceIndex as Integer, nInputChannelFirst as Integer, nOutputChannelFirst as Integer, nTotalChannels as Integer ) as enumErrorCodes |
[C++] short control.ASIO.DeviceListenInputStart ( short nDeviceIndex, short nInputChannelFirst, short nOutputChannelFirst, short nTotalChannels ); |
Parameter |
Description |
|
|
nDeviceIndex |
Number representing the zero-based index of the ASIO device. This index is related to available ASIO devices so it must be the related to the enumeration performed through the ASIO.DeviceGetCount and ASIO.DeviceGetDesc methods: it must not be confused with indexes related to generic output devices enumerated through the GetOutputDevicesCount and GetOutputDeviceDesc methods which may contain both DirectSound and ASIO devices. |
nInputChannelFirst |
Zero-based index of the first input channel used for getting incoming audio data. |
nOutputChannelFirst |
Zero-based index of the first output channel used for direct playback of incoming audio data. |
nTotalChannels |
Total number of input/output channels |
Return value
Value |
Meaning |
|
|
Negative value |
An error occurred (see the LastError property for further error details) |
enumErrorCodes.ERR_NOERROR (0) |
The method call was successful |
