IIsdbDigitalCopyControlDescriptor::GetRecordCopyControl 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 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 |
|---|---|
|
Unrestricted copies allowed. |
|
When pbCopyControlType parameter is 11, not used; when pbCopyControlType is 01, copying forbidden. |
|
Can be copied only once. |
|
Copying forbidden. |
[out] pbCopyControlType
Receives data that defines output control options for digital copying.
| Value | Meaning |
|---|---|
|
Undefined. |
|
Output by encoding to serial interface. |
|
Undefined. |
|
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 |
|---|---|
|
Undefined. |
|
Output with pseudosync pulse |
|
Output with pseudosync pulse + two-line reversed division burst insertion. |
|
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) |