Methods > Recorders > StartFromClipboard method

Remarks

Starts a new recording session from a sound contained inside the system clipboard.

In order to understand if a CF_WAVE format sound is available inside the clipboard you can call the IsSoundAvailableInClipboard method.

A successful call to this method will fire the RecordingStarted event followed by a number of RecordingPerc events and finally by the RecordingStopped event.

For details about recording from files see the How to record from files, memory or clipboard section.

Syntax

[Visual Basic]

control.StartFromClipboard (

strOutputPath as string

) as enumErrorCodes

[C++]

short control.StartFromClipboard (

LPCTSTR strOutputPath

);

Parameter

Description

strOutputPath

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

If the string is left empty, the recording session will be performed in memory.

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.