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

IRP_MJ_DEVICE_CONTROL

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)

Consulte también

SUB_Q_CHANNEL_DATA