IIsdbDigitalCopyControlDescriptor::GetCopyControl method (dvbsiparser.h)

[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 an Integrated Services Digital Broadcasting (ISDB) digital copy control descriptor.

Syntax

HRESULT GetCopyControl(
  [out] BYTE *pbDigitalRecordingControlData,
  [out] BYTE *pbCopyControlType,
  [out] BYTE *pbAPSControlData,
  [out] BYTE *pbMaximumBitrate
);

Parameters

[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

IIsdbDigitalCopyControlDescriptor