Microsoft DirectX 8.1 (C++) |
The DVD Copy Protection property set provides authentication of copy protection information from hardware or software decrypters. Use this property set to prevent unauthorized copying from prerecorded DVD-Video.
Microsoft provides software that facilitates the authentication process required by the encryption scheme, thus enabling a DVD-ROM drive to authenticate and transfer keys with a DVD decrypter. Microsoft has no current plans to ship a DVD decrypter and, instead, is providing operating system code that will act as the agent to enable authentication of either hardware or software decrypters.
The DVD navigator initiates and controls the key exchange process. The DVD minidriver needs only to implement the following properties. Other components handle the rest.
Each DVD input stream will receive copy protection properties. This is true even if the same hardware controls all DVD streams.
The following information presents the necessary constants and data types to use for this property set in calls to IKsPropertySet methods. It provides values for the GUID (guidPropSet), property ID (dwPropID), and property data type (pPropData) parameters.
Property Set GUID: AM_KSPROPSETID_CopyProt
Property ID | Data type used by the specified property |
AM_PROPERTY_COPY_MACROVISION | AM_COPY_MACROVISION |
AM_PROPERTY_DVDCOPY_CHLG_KEY | AM_DVDCOPY_CHLGKEY |
AM_PROPERTY_DVDCOPY_DEC_KEY2 | AM_DVDCOPY_BUSKEY |
AM_PROPERTY_DVDCOPY_DISC_KEY | AM_DVDCOPY_DISCKEY |
AM_PROPERTY_DVDCOPY_DVD_KEY1 | AM_DVDCOPY_BUSKEY |
AM_PROPERTY_DVDCOPY_REGION | The DVD_REGION structure. |
AM_PROPERTY_DVDCOPY_SET_COPY_STATE | AM_DVDCOPY_SET_COPY_STATE |
AM_PROPERTY_DVDCOPY_TITLE_KEY | AM_DVDCOPY_TITLEKEY |
The following list provides the DVD Copy Protection property IDs and descriptions.
AM_PROPERTY_COPY_MACROVISION
This is a set-only property. This property sets the Macrovision level for the NTSC encoder on the output end of the receiving pin.
AM_PROPERTY_DVDCOPY_CHLG_KEY
Both get and set operations are supported on this property. A get operation requests the decoder to provide its bus challenge key. A set operation provides the decoder with the bus challenge key from the DVD drive. The data passed in this property will be a structure of type AM_DVDCOPY_CHLGKEY.
AM_PROPERTY_DVDCOPY_DEC_KEY2
This is a get-only property. This property requests that the decoder's bus key 2 be transferred to the DVD drive. The data passed will be a structure of type AM_DVDCOPY_BUSKEY.
AM_PROPERTY_DVDCOPY_DISC_KEY
Set-only property. This provides disc key. The key is a structure of type AM_DVDCOPY_DISCKEY.
AM_PROPERTY_DVDCOPY_DVD_KEY1
This is a set-only property. This property provides the DVD drive bus key 1 to the decoder. The data passed will be a structure of type AM_DVDCOPY_BUSKEY.
AM_PROPERTY_DVDCOPY_SET_COPY_STATE
Both get and set are supported on this property. Get is called first to determine if authentication is required. The set properties are indications as to which phase of copy protection negotiation the filter is entering. The data passed will be a structure of type AM_DVDCOPY_SET_COPY_STATE.
AM_PROPERTY_DVDCOPY_REGION
Region code requests the region definition that the decoder is allowed to play in as defined by the DVD consortium. This region is defined by the following structure:
typedef struct _DVD_REGION {
UCHAR CopySystem; //specifies whether the disk is copy protected
UCHAR RegionData; //information about the region from decoder
UCHAR SystemRegion; //information about region from DVD drive
UCHAR Reserved; //reserved
} DVD_REGION, *PDVD_REGION;
AM_PROPERTY_DVDCOPY_TITLE_KEY
This is a set-only property. This provides title key from current content. The key is a structure of type AM_DVDCOPY_TITLEKEY.
Use the IKsPropertySet interface to set, retrieve, and query for support of these properties.
This property set uses the following data types.
Data type | Description |
AM_COPY_MACROVISION | Macrovision level for the NTSC encoder. |
AM_COPY_MACROVISION_LEVEL | Macrovision level. The AM_COPY_MACROVISION structure uses this data type. |
AM_DVDCOPY_BUSKEY | DVD bus key. |
AM_DVDCOPY_CHLGKEY | DVD challenge key. |
AM_DVDCOPY_DISCKEY | DVD disc key. |
AM_DVDCOPY_SET_COPY_STATE | Determines the copy protection state of the filter. |
AM_DVDCOPYSTATE | Copy protection state. The AM_DVDCOPY_SET_COPY_STATE structure uses this data type. |
AM_DVDCOPY_TITLEKEY | DVD title key from the current content. |