DVD_COPY_PROTECT_KEY - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// ntddcdvd.h
typedef struct _DVD_COPY_PROTECT_KEY {
ULONG KeyLength;
DVD_SESSION_ID SessionId;
DVD_KEY_TYPE KeyType;
ULONG KeyFlags;
union {
HANDLE FileHandle;
LARGE_INTEGER TitleOffset;
} Parameters;
UCHAR KeyData[0];
} DVD_COPY_PROTECT_KEY, *PDVD_COPY_PROTECT_KEY;
View the official Windows Driver Kit DDI referenceNo description available.
The DVD_COPY_PROTECT_KEY structure is used in conjunction with the IOCTL_DVD_READ_KEY request to execute a report key command of the specified type.
KeyLengthIndicates the length of the key data to be retrieved.
SessionIdIndicates the DVD session ID. The Authentication Grant Identifier (AGID) for a secure Advanced Access Content System (AACS) session is a long integer in the range -1 to 3 inclusive.
KeyTypeIndicates the key type. The DVD device driver uses this information 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 either reports key data for a specified key (challenge key, bus key, title key, RPC key, or disk key), reports the state of the authentication success flag (ASF), or invalidates an authentication grant ID (AGID). See the MMC-3 specification for further information.
KeyFlagsParametersParameters.FileHandlePointer to the file handle for the physical device that the copy protection is being negotiated on.
Parameters.TitleOffsetContains the logical block address on the media of the title.
The upper layers of the operating system use the FileHandle member. The file system converts the value in FileHandle into a logical block address and stores the result in the TitleOffset member. Kernel-mode drivers use the TitleOffset member.
KeyDataContains the key data that was returned.