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

IRP_MJ_DEVICE_CONTROL

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)

Voir aussi

SUB_Q_CHANNEL_DATA