Remarks
Enables/disables the splitting in chunks of a recording session whose EncodeFormats.ForRecording property is set to ENCODING_FORMAT_WAV and the EncodeFormats.WAV.EncodeMode property is set to one between WAV_ENCODE_PCM_U8, WAV_ENCODE_PCM_S16 or WAV_ENCODE_FLOAT32: this method call will be ignored when using other encoding formats and/or encoding modes.
Splitting is disabled by default. When splitting is enabled, the control will automatically save on output files (chunks) the given duration of sound data: it's important to note that the recording session will in any case continue storing sound data on the original output file.
Each time a chunk is completed and saved the container application to be notified through the CallbackForRecordersEvents delegate invoked with the nEvent parameter set to EV_REC_WAV_CHUNK_SAVED.
Syntax
[Visual Basic]
Public Function SplitWavRecordingEnable (
bEnable as Boolean,
nChunkDurationInMs as Int32,
strChunkOutputPath as string,
strChunkFilenamePrefix as string
) as enumErrorCodes
|
|
[C#]
public enumErrorCodes SplitWavRecordingEnable (
bool bEnable,
Int32 nChunkDurationInMs,
string strChunkOutputPath,
string strChunkFilenamePrefix
);
|
|
[C++]
public: enumErrorCodes SplitWavRecordingEnable (
bool bEnable,
Int32 nChunkDurationInMs,
string strChunkOutputPath,
string strChunkFilenamePrefix
);
|
|
Parameter
|
Description
|
|
|
bEnable
|
Boolean flag that enables/disables the splitting procedure.
Supported values are the following:
Value
|
Meaning
|
false
|
Disables splitting
|
true
|
Enables splitting
|
|
nChunkDurationInMs
|
Numeric values which defines the duration for each saved chunk expressed in milliseconds
|
strChunkOutputPath
|
String representing the absolute path where chunks will be saved, for example "C:\MyFolder\"
|
strChunkFilenamePrefix
|
String representing the prefix of the chunk filename, for example "MyChunk": each time a new chunk is saved, the filename will be modified adding the number of the chunk followed by the ".wav" extension (MyChunk1.wav, MyChunk2.wav, MyChunk3.wav, etc.)
If this parameter is left empty, the control will automatically set the filename prefix to "WavChunk".
|
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.
|
|
