IOCTL_CDROM_READ_TOC_EX IOCTL (ntddcdrm.h)
Interroge l’appareil cible pour la table des matières (TOC), la zone mémoire du programme (PMA) et le temps absolu dans le prégroove (ATIP). Si les médias ne sont pas un CD-ROM et ne prennent pas en charge un TOC, ce CIOTL renvoie des informations similaires à celles d’un CD-ROM TOC. Cela est nécessaire 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 quelles informations doivent être récupérées à 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 à 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 Status est défini sur STATUS_SUCCESS, ou éventuellement sur STATUS_BUFFER_TOO_SMALL ou STATUS_INSUFFICIENT_RESOURCES.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows XP et les systèmes d’exploitation ultérieurs. |
| d’en-tête | ntddcdrm.h (include Ntddcdrm.h) |