IETFilter::SetRecordingOn
| Microsoft DirectShow 9.0 |
IETFilter::SetRecordingOn
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 Values
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: EncDec.h.
See Also