IOCTL_CDROM_READ_Q_CHANNEL IOCTL (ntddcdrm.h)
Devuelve la posición actual, el catálogo multimedia o los datos de seguimiento de ISRC. La lectura de la posición actual está obsoleta, empezando por Windows Vista.
Código principal
Búfer de entrada
El búfer de Irp-AssociatedIrp.SystemBuffer> contiene una estructura de CDROM_SUB_Q_DATA_FORMAT con el miembro Format establecido en uno de los siguientes:
IOCTL_CDROM_CURRENT_POSITION
IOCTL_CDROM_MEDIA_CATALOG
IOCTL_CDROM_TRACK_ISRC
Si Format está establecido en IOCTL_CDROM_TRACK_ISRC, Track debe establecerse en la pista para la que se solicitan los datos isrc.
Longitud del búfer de entrada
La longitud de parameters.DeviceIoControl.OutputBufferLength en la ubicación de la pila de E/S indica el tamaño, en bytes, del búfer, que debe ser >= sizeof(SUB_Q_CHANNEL_DATA).
.
Búfer de salida
El controlador devuelve la información de SUB_Q_CHANNEL_DATA en el búfer en Irp-AssociatedIrp.SystemBuffer>.
Longitud del búfer de salida
Longitud de un SUB_Q_CHANNEL_DATA.
Bloque de estado
El campo Información se establece en el número de bytes devueltos. El campo Estado se establece en STATUS_SUCCESS, o posiblemente en 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 o STATUS_VERIFY_REQUIRED.
Comentarios
A partir de Windows Vista, los controladores de clase CDROM no usan este IOCTL con el miembro de formato establecido en IOCTL_CDROM_CURRENT_POSITION. Antes de Windows Vista, este IOCTL se usaba para la reproducción de audio en unidades de CD-ROM anteriores que admitía la salida de audio directa en hardware.
Las aplicaciones cliente deben usar la API de interfaz de control multimedia (MCI) en lugar de emitir este IOCTL.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Obsoleto, empezando por Windows Vista. |
| Encabezado | ntddcdrm.h (incluya Ntddcdrm.h) |