IOCTL_AACS_READ_MEDIA_KEY_BLOCK_SIZE IOCTL (ntddcdvd.h)

Interroge l’unité logique pour connaître la taille de la mémoire tampon requise pour contenir le bloc de clé multimédia (MKB) advanced Access Control System (AACS).

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

La mémoire tampon dans Irp-AssociatedIrp.SystemBuffer> contient le numéro AACS_LAYER_NUMBER de la couche. Le AACS_LAYER_NUMBER est une valeur entière longue non signée comprise entre 0 et 255 inclus qui spécifie la couche du média auquel une commande s’applique.

typedef ULONG AACS_LAYER_NUMBER, *PAACS_LAYER_NUMBER;

Longueur de la mémoire tampon d’entrée

Parameters.DeviceIoControl.InputBufferLength dans l’emplacement de la pile d’E/S indique la taille, en octets, de la mémoire tampon, qui doit être >= sizeof(AACS_LAYER_NUMBER).

Mémoire tampon de sortie

La mémoire tampon sur Irp-AssociatedIrp.SystemBuffer> contient un ULONG qui contient la taille en octets de la MKB AACS complète pour ce média.

Longueur de la mémoire tampon de sortie

Utilisez cette valeur pour déterminer la taille de la mémoire tampon à allouer pour IOCTL_AACS_READ_MEDIA_KEY_BLOCK. La taille est toujours un multiple de 32 768 (0x8000).

Bloc d’état

Le champ Informations est défini sur le nombre d’octets transférés. Le champ État est défini sur STATUS_SUCCESS si l’opération réussit. Les codes d’échec suivants sont courants avec cette opération :

STATUS_COPY_PROTECTION_FAILURE ou STG_E_STATUS_COPY_PROTECTION_FAILURE

Échec de l’un des mécanismes de protection contre la copie.

STATUS_CSS_AUTHENTICATION_FAILURE ou STG_E_CSS_AUTHENTICATION_FAILURE

Le processus d’authentification a échoué.

STATUS_CSS_KEY_NOT_ESTABLISHED ou STG_E_CSS_KEY_NOT_ESTABLISHED

L’AGID pour AACS n’a pas été établie.

STATUS_CSS_KEY_NOT_PRESENT ou STG_E_CSS_KEY_NOT_PRESENT

Il n’existe aucune protection AACS pour ce média.

Remarques

La requête IOCTL_AACS_READ_MEDIA_KEY_BLOCK_SIZE ne fonctionnera pas si le média de l’unité logique n’est pas protégé par AACS.

La demande IOCTL_AACS_READ_MEDIA_KEY_BLOCK_SIZE correspond à l’une des étapes de l’algorithme d’authentification AACS (Advanced Access Content System) (AACS-Auth). Pour obtenir une description complète d’AACS-Auth, consultez la spécification Advanced Access Content System, Introduction and Common Cryptographic Elements publiée par Advanced Access Content System Administrator (AACS LA).

Configuration requise

Condition requise	Valeur
En-tête	ntddcdvd.h (incluez Ntddcdvd.h)