IOCTL_CDROM_READ_Q_CHANNEL IOCTL (ntddcdrm.h)
Retourne la position actuelle, le catalogue multimédia ou les données de suivi ISRC. La lecture de la position actuelle est obsolète, à compter de Windows Vista.
Code principal
Mémoire tampon d'entrée
La mémoire tampon dans Irp-AssociatedIrp.SystemBuffer> contient une structure CDROM_SUB_Q_DATA_FORMAT avec le membre Format défini sur l’un des éléments suivants :
IOCTL_CDROM_CURRENT_POSITION
IOCTL_CDROM_MEDIA_CATALOG
IOCTL_CDROM_TRACK_ISRC
Si Format est défini sur IOCTL_CDROM_TRACK_ISRC, Track doit être défini sur la piste pour laquelle les données ISRC sont demandées.
Longueur de la mémoire tampon d’entrée
La longueur d’un Parameters.DeviceIoControl.OutputBufferLength dans l’emplacement de la pile d’E/S indique la taille, en octets, de la mémoire tampon, qui doit être >= sizeof(SUB_Q_CHANNEL_DATA).
.
Mémoire tampon de sortie
Le pilote retourne les informations SUB_Q_CHANNEL_DATA dans la mémoire tampon à l’adresse Irp-AssociatedIrp.SystemBuffer>.
Longueur de la mémoire tampon de sortie
Longueur d’un SUB_Q_CHANNEL_DATA.
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, STATUS_IO_DEVICE_ERROR, STATUS_INSUFFICIENT_RESOURCES, STATUS_INVALID_DEVICE_REQUEST, STATUS_NO_MEDIA_IN_DEVICE, STATUS_DEVICE_NOT_READY, STATUS_IO_TIME_OUT ou STATUS_VERIFY_REQUIRED.
Remarques
À compter de Windows Vista, les pilotes de classe CDROM n’utilisent pas ce IOCTL avec le format membre défini sur IOCTL_CDROM_CURRENT_POSITION. Avant Windows Vista, ce IOCTL était utilisé pour la lecture audio sur les anciens lecteurs de CD-ROM qui pris en charge la sortie audio directe dans le matériel.
Les applications clientes doivent utiliser l’API MCI (Media Control Interface) plutôt que d’émettre ce IOCTL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Obsolète, à compter de Windows Vista. |
| En-tête | ntddcdrm.h (inclure Ntddcdrm.h) |