IStreamBufferSink::CreateRecorder Method

This topic applies only to Windows XP Service Pack 1 or later.
The CreateRecorder method creates a new Recording object. Recording objects are used to create permanent files from the stream buffer.

Syntax

HRESULT CreateRecorder(
  [in]   LPCWSTR pszFilename,
  [in]   DWORD dwType,
  [out]  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 Value

Returns an HRESULT. Possible values include those in the following table.

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

See Also

Creating Stream Buffer Recordings
IStreamBufferSink Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008