IOCTL_AACS_READ_MEDIA_KEY_BLOCK_SIZE IOCTL (ntddcdvd.h)
Interroge l’unité logique pour la taille de la mémoire tampon requise pour contenir le bloc de clé multimédia AACS (Advanced Access Control System).
Code principal
Mémoire tampon d’entrée
La mémoire tampon à Irp->AssociatedIrp.SystemBuffer contient le nombre 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 support 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 à Irp->AssociatedIrp.SystemBuffer contient un ULONG qui contient la taille en octets du MKB AACS complet 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 Status 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
Aucune protection AACS n’existe 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 requête 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 Advanced Access Content System, Introduction and Common Cryptographic Elements specification qui est publiée par Advanced Access Content System Licensing Administrator (AACS LA).
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ntddcdvd.h (include Ntddcdvd.h) |