IStreamBufferSink::CreateRecorder method (sbe.h)

Article
12/05/2018

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

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    dwRecordType,
  [out] IUnknown **pRecordingIUnknown
);

Parameters

[in] pszFilename

Pointer to a null-terminated wide-character string that contains the file name for the recording.

[in] dwRecordType

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.

[out] pRecordingIUnknown

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.

Return code	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

Requirement	Value
Minimum supported client	Windows�XP with SP1 [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	sbe.h

Share via