| Microsoft DirectX 9.0 |
This topic applies to Windows XP Service Pack 1 only.
The CreateRecorder method creates a new Recording object. Recording objects are used to create permanent files from the stream buffer.
Syntax
HRESULT CreateRecorder(
LPCWSTR pszFilename,
DWORD dwType,
IUnknown** pRecordingIUnknown
);
Parameters
pszFilename
[in] Pointer to a null-terminated wide-character string that contains the file name for the recording.
dwType
[in] Indicates the type of recording to create, either a reference recording or a content recording. Specify one of the following values.
| Value | Description |
| RECORDING_TYPE_REFERENCE | Reference recording. A reference recording is created from temporary backing files that have already been recorded. It uses a stub file to reference the existing files. Because a reference recording refers to existing content, the start time can be in the past. |
| RECORDING_TYPE_CONTENT | Content recording. A content recording saves content into a new file. Because the content must be new, the start time cannot be in the past. |
pRecordingIUnknown
[out] Address of a variable that receives a pointer to the Recording object's IUnknown interface.
Return Values
Returns an HRESULT. Possible values include those in the following table.
| Value | Description |
| S_OK | The method succeeded. |
Remarks
The Stream Buffer Sink filter's profile must be locked, either explicitly or implicitly, before you call this method. For more information, see IStreamBufferSink::LockProfile.
The returned IUnknown interface has an outstanding reference count. The caller must release the interface.
Requirements
Include Sbe.h.
See Also