IDVDDecoderCSS
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This interface provides implementation support for the DVD CSS protocol.
A pointer to an IDVDDecoderCSS interface can be obtained by calling the IUnknown::QueryInterface method of an IDVDRenderer:IUnknown object and specifying the IID_IDVDDECODERCSS reference identifier.
The IDVDDecoderCSS interface has the following methods.
| Method | Description |
|---|---|
Sets the sector length, in bytes, for a decoder. |
|
Notifies the decoder that a new disk has been inserted. |
|
Called in order to enter authentication and negotiation processes before any key transfer operations can take place. |
|
Gets the challenge key from a decoder chip. |
|
Sends the drive challenge response to the DVD renderer. |
|
Sends the DVD drive challenge key to the DVD decoder. |
|
Gets the DVD chip challenge response key. |
|
Terminates the authentication process. |
|
Transfers the 2048-byte scrambled disk key data. |
|
Sends the title key to the appropriate location. |
|
Enables the descrambler at the end of title authentication process and before playback has begun. |
|
Bypasses the descrambler for disks with fake encryption. |
The IDVDDecoderCSS interface, like all COM interfaces, inherits the IUnknown interface methods. The IUnknown interface supports the following three methods:
The following code needs to be implemented and exposed by the decoder in order to implement DVD CSS protocol. It needs to be QI-able from the IDVDRenderer interface.
typedef struct { UINT8 key[5]; } CSS_KEY;
typedef struct { UINT8 challenge[10]; } CSS_CHALLENGE;
typedef struct { UINT8 sdks[2048]; } CSS_SDKS;
Requirements
| Header | dvdcss.idl |
| Windows Embedded CE | Windows CE .NET 4.0 and later |