IIsdbDigitalCopyControlDescriptor::GetRecordCopyControl method (dvbsiparser.h)

  • Article

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

Gets copy control data from a specified component in an Integrated Services Digital Broadcasting (ISDB) digital copy control descriptor. When the component_control_flag field in the descriptor is set to 1, the control information is specified in each component of the descriptor.

Syntax

HRESULT GetRecordCopyControl(
  [in]  BYTE bRecordIndex,
  [out] BYTE *pbComponentTag,
  [out] BYTE *pbDigitalRecordingControlData,
  [out] BYTE *pbCopyControlType,
  [out] BYTE *pbAPSControlData,
  [out] BYTE *pbMaximumBitrate
);

Parameters

[in] bRecordIndex

Specifies the record number for the component, indexed from zero. Call the IIsdbDigitalCompyControlDescriptor::GetCountOfRecords method to get the number of records in the digital copy control descriptor.

[out] pbComponentTag

Receives the tag identifying the component. This value is the same as the component tag in the stream identifier descriptor and the component descriptor.

[out] pbDigitalRecordingControlData

Receives the two-bit code that indicates the type of copy control. This code can have any of the following values.

Value Meaning
00
 Unrestricted copies allowed.
01
 When pbCopyControlType parameter is 11, not used; when pbCopyControlType is 01, copying forbidden.
10
 Can be copied only once.
11
 Copying forbidden.

[out] pbCopyControlType

Receives data that defines output control options for digital copying.

Value Meaning
00
 Undefined.
01
 Output by encoding to serial interface.
10
 Undefined.
11
 Output by not encoding to serial interface.

[out] pbAPSControlData

Receives data that defines output control options for analog copying when the value of the pbCopyControlType parameter is 01.

Value Meaning
00
 Undefined.
01
 Output with pseudosync pulse
10
 Output with pseudosync pulse + two-line reversed division burst insertion.
11
 Output with pseudosync pulse + four-line reversed division burst insertion.

[out] pbMaximumBitrate

Receives the maximum transmission rate for transport stream packets, in units of 250 kbps.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows�7 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header dvbsiparser.h (include Dvbsiparser.idl)

See also

IIsdbDigitalCompyControlDescriptor::GetCountOfRecords

IIsdbDigitalCopyControlDescriptor