IOCTL_CDROM_READ_TOC_EX IOCTL (ntddcdrm.h)
Interroge l’appareil cible pour la table des matières (TOC), la zone de mémoire du programme (PMA) et l’heure absolue en préinversion (ATIP). Si le média n’est pas un CD-ROM et ne prend pas en charge une table des matières, ce IOCTL renvoie des informations similaires à celles d’une table des matières de CD-ROM. Cela est requis pour la compatibilité avec certains environnements initiateurs hérités.
Code principal
Mémoire tampon d'entrée
Irp->AssociatedIrp.SystemBuffer pointe vers une mémoire tampon de type CDROM_READ_TOC_EX dont le contenu indique les informations à récupérer à partir de l’appareil cible.
Parameters.Read.Length dans l’emplacement de la pile d’E/S indique la taille, en octets, des informations à récupérer à partir de l’appareil cible.
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 d’entrée, qui doit être >= sizeof(CDROM_READ_TOC_EX).
Mémoire tampon de sortie
Le pilote retourne les données de requête dans la mémoire tampon dans Irp-AssociatedIrp.SystemBuffer>.
Longueur de la mémoire tampon de sortie
Parameters.DeviceIoControl.OutputBufferLength dans l’emplacement de la pile d’E/S indique la taille, en octets, de la mémoire tampon de sortie, qui doit être >= MINIMUM_CDROM_READ_TOC_EX_SIZE.
Bloc d’état
Le champ Informations est défini sur le nombre d’octets retournés. Le champ État est défini sur STATUS_SUCCESS, ou éventuellement sur STATUS_BUFFER_TOO_SMALL ou STATUS_INSUFFICIENT_RESOURCES.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans les systèmes d’exploitation Windows XP et ultérieurs. |
| En-tête | ntddcdrm.h (inclure Ntddcdrm.h) |