IOCTL_AACS_READ_VOLUME_ID IOCTL

Description

Reads the Advanced Access Content System (AACS)-specific volume identifier.

Parameters

Major code

Input buffer

The buffer at Irp->AssociatedIrp.SystemBuffer contains a value of type DVD_SESSION_ID that specifies an Authentication Grant Identifier (AGID). The AGID identifies the secure session that is associated with the volume.

Input buffer length

Length of a DVD_SESSION_ID.

Output buffer

The buffer at Irp->AssociatedIrp.SystemBuffer contains the value of type AACS_VOLUME_ID that specifies the volume ID.

Output buffer length

Length of an AACS_VOLUME_ID.

Input/output buffer

Input/output buffer length

Status block

The Information field is set to the number of bytes transferred. The Status field is set to STATUS_SUCCESS or possibly STATUS_INSUFFICIENT_RESOURCES.

Remarks

The IOCTL_AACS_READ_VOLUME_ID request corresponds to the part of the AACS authentication protocol that is responsible for transferring the volume identifier. For a complete description of this protocol, see the Advanced Access Content System, Introduction and Common Cryptographic Elements specification that is published by Advanced Access Content System Licensing Administrator (AACS LA).

The AGID is automatically released after the IOCTL_AACS_READ_VOLUME_ID request completes.