Partager via

IETFilter::SetRecordingOn

  • Article
 
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