Edit

Share via

DVD_KEY_TYPE enumeration (ntddcdvd.h)

  • Article

The DVD_KEY_TYPE enumeration type is used in conjunction with the DVD_COPY_PROTECT_KEY structure to indicate a key to be read, to invalidate an authentication grant ID (AGID), and to request state information or region settings.

Syntax

typedef enum {
  DvdChallengeKey,
  DvdBusKey1,
  DvdBusKey2,
  DvdTitleKey,
  DvdAsf,
  DvdSetRpcKey,
  DvdGetRpcKey,
  DvdDiskKey,
  DvdInvalidateAGID
} DVD_KEY_TYPE;

Constants

 
DvdChallengeKey
Gets a challenge key. This is used during the authentication key exchange process.
DvdBusKey1
Gets the first bus key.
DvdBusKey2
Gets the second bus key.
DvdTitleKey
Gets a title key that is obfuscated by a bus key.
DvdAsf
Gets the current state of the authentication success flag (ASF).
DvdSetRpcKey
Sets the region playback contents (RPC) for the logical unit.
DvdGetRpcKey
Gets the region playback contents (RPC) for the logical unit.
DvdDiskKey
Gets the disc key.
DvdInvalidateAGID
Invalidates the specified authentication grant ID (AGID).

Remarks

The driver for the DVD device uses the key type specified in this enumeration type to determine the key format in a report key command, as defined by the SCSI Multimedia Commands - 3 (MMC-3) specification. A report key command can either report key data for a specified key (challenge key, bus key, title key, RPC key, or disc key), or the state of the ASF flag. It can also invalidate an AGID. See the MMC-3 specification for further information.

Drivers can issue a report key command to retrieve key data by means of an IOCTL_DVD_READ_KEY request.

Requirements

Requirement Value
Header ntddcdvd.h (include Ntddcdvd.h)

See also

DVD_COPY_PROTECT_KEY

IOCTL_DVD_READ_KEY

IOCTL_DVD_SEND_KEY