IOCTL_AACS_READ_MEDIA_KEY_BLOCK_SIZE IOCTL

Queries the logical unit for the size of the buffer that is required to hold the Advanced Access Control System (AACS) Media Key Block (MKB).

Major Code

IRP_MJ_DEVICE_CONTROL

Input Buffer

The buffer at Irp->AssociatedIrp.SystemBuffer contains the AACS_LAYER_NUMBER number of the layer. The AACS_LAYER_NUMBER is an unsigned long integer value in the range 0 to 255 inclusive that specifies the layer of the media to which a command applies.

typedef ULONG AACS_LAYER_NUMBER, *PAACS_LAYER_NUMBER;

Input Buffer Length

Parameters.DeviceIoControl.InputBufferLength in the I/O stack location indicates the size, in bytes, of the buffer, which must be >= sizeof(AACS_LAYER_NUMBER).

Output Buffer

The buffer at Irp->AssociatedIrp.SystemBuffer contains a ULONG that holds the size in bytes of the full AACS MKB for this media.

Output Buffer Length

Use this value to determine the size of the buffer to allocate for IOCTL_AACS_READ_MEDIA_KEY_BLOCK. The size is always a multiple of 32,768 (0x8000).

Status Block

The Information field is set to the number of bytes transferred. The Status field is set to STATUS_SUCCESS if the operation succeeds. The following failure codes are common with this operation:

Remarks

The IOCTL_AACS_READ_MEDIA_KEY_BLOCK_SIZE request will not work if the media in the logical unit is not AACS protected.

The IOCTL_AACS_READ_MEDIA_KEY_BLOCK_SIZE request corresponds to one of the steps of the Advanced Access Content System (AACS) authentication algorithm (AACS-Auth). For a complete description of AACS-Auth, see the Advanced Access Content System, Introduction and Common Cryptographic Elements specification that is published by Advanced Access Content System Licensing Administrator (AACS LA).

Requirements

   
Header ntddcdvd.h (include Ntddcdvd.h)