Share via


IETFilter::SetRecordingOn Method

This topic applies to Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005.
The SetRecordingOn method signals to the Encrypter/Tagger filter that the Video Control is about to start or stop recording.

Syntax

HRESULT SetRecordingOn(
    BOOL fRecState
);

Parameters

  • fRecState
    TRUE if recording is about to start, or FALSE if recording is about to stop.

Return Value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description

S_OK

The method succeeded.

Remarks

The SetRecordingOn method enables the Video Control to enforce copy protection in the television broadcast signal. When the Video Control uses the Stream Buffer Engine to play television content, the Encrypter/Tagger filter is located in the Stream Buffer Sink graph. The Encrypter/Tagger sends data to the Stream Buffer Sink for both playback and recording. When SetRecordingOn is called with the value TRUE, the Encrypter/Tagger watches the video stream for the copy protection flags and sends a broadcast event if they change. The Video Control listens for the event and disallows the recording if indicated by the copy protection flag.

Requirements

Header Declared in EncDec.h.

See Also

IETFilter Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008