Methods > Recorders > StartFromDjStudioMixer method

Remarks

Starts a recording session getting sound data from the output of a given custom stream mixer instanced by Active DJ Studio.

In case the output of the stream mixer should be multi-channel meaning that it was created using the StreamMixerCreateWithSurround method of Active DJ Studio, the recorder could keep channels separated only in case the format of the output file should support multi-channel too, like WAV, Ogg Vorbis, Opus and WMA formats.

Calling this method will cause the control to fire a RecordingStarted event. The recording session can be stopped at any time through a call to the Stop method.

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

For details about the use of custom stream mixers, see the "How to use custom Stream Mixers" tutorial inside the documentation of Active DJ Studio.

Syntax

[Visual Basic]

control.StartFromDjStudioMixer (

nStreamMixerID as integer,

strOutputPath as string

) as enumErrorCodes

[C++]

short control.StartFromDjStudioMixer (

short nStreamMixerID,

LPCTSTR strOutputPath

);

Parameter	Description

nStreamMixerID	Number representing the unique identifier of the stream mixer. This unique identifier is assigned by Active DJ Studio after calling its its StreamMixerCreate or StreamMixerCreateWithSurround method.
strOutputPath	String representing the absolute pathname of the output file that will contain recorded data. If this pathname should contain invalid characters, they would be automatically changed into an underscore '_' character. If this parameter is left empty, recorded data will be stored inside a memory buffer.

Return value

Value	Meaning

Negative value	An error occurred, check the LastError property value in order to see the error code meaning
enumErrorCodes.ERR_NOERROR (0)	The method call was successful.