Copyright © 2006-2019 MultiMedia Soft

StartSplitFromWasapiCaptureDevice method

Previous pageReturn to chapter overviewNext page

Remarks

 

Starts a new recording session from the given WASAPI capture device and splits incoming sound in left and right channels.

The given WASAPI capture device must be previously started through the WASAPI.DeviceStartExcusive or WASAPI.DeviceStartShared methods. You can know if a WASAPI device is already started through the WASAPI.DeviceIsStarted method.

 

After calling this method, the container application is notified through the CallbackForRecordersEvents delegate invoked with the nEvent parameter set to EV_REC_START.

The recording session can be stopped at any time through a call to the Stop method.

 

This method is only intended for usage with Windows Vista and later versions.

For further details about the use of WASAPI see the WASAPI object and the How to manage audio flow through WASAPI tutorial.

For details about the encoding format and parameters applied during recording see the How to perform a recording session section.

 

 

Syntax

 

[Visual Basic]

Public Function StartSplitFromWasapiCaptureDevice (

nCaptureDevice as Int32,

strOutputPathLeft as String,

strOutputPathRight as String

) as enumErrorCodes


 

[C#]

public enumErrorCodes StartSplitFromWasapiCaptureDevice (

Int32 nCaptureDevice,

string strOutputPathLeft,

string strOutputPathRight

);


 

[C++]

public: enumErrorCodes StartSplitFromWasapiCaptureDevice (

Int32 nCaptureDevice,

string strOutputPathLeft,

string strOutputPathRight

);


 

 

Parameter

Description

 

 

nCaptureDevice

Number representing the zero-based index of the WASAPI capture device of interest. The total number of available WASAPI capture devices can be obtained using the WASAPI.DeviceGetCount method having the nDeviceType parameter set to WASAPI_DEVICE_TYPE_CAPTURE.

strOutputPathLeft

String representing the absolute pathname of the destination file that will contain the left channel of recorded data. If this pathname should contain invalid characters, they would be automatically changed into an underscore '_' character.

strOutputPathRight

String representing the absolute pathname of the destination file that will contain the right channel of recorded data. If this pathname should contain invalid characters, they would be automatically changed into an underscore '_' character.

 

 

Return value

 

Value

Meaning

 

 

Negative value

An error occurred. Check the LastError property value in order to see the last error.

enumErrorCodes.ERR_NOERROR (0)

The method call was successful.