IOCTL_CDROM_READ_Q_CHANNEL IOCTL (ntddcdrm.h)

Restituisce la posizione corrente, il catalogo multimediale o i dati di traccia ISRC. La lettura della posizione corrente è obsoleta, a partire da Windows Vista.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Il buffer in Irp-AssociatedIrp.SystemBuffer> contiene una struttura CDROM_SUB_Q_DATA_FORMAT con il membro Format impostato su uno dei seguenti:

IOCTL_CDROM_CURRENT_POSITION

IOCTL_CDROM_MEDIA_CATALOG

IOCTL_CDROM_TRACK_ISRC

Se Format è impostato su IOCTL_CDROM_TRACK_ISRC, Track deve essere impostato sulla traccia per cui sono richiesti i dati ISRC.

Lunghezza del buffer di input

Lunghezza di un parametro.DeviceIoControl.OutputBufferLength nella posizione dello stack I/O indica le dimensioni, in byte, del buffer, che deve essere >= sizeof(SUB_Q_CHANNEL_DATA).

.

Buffer di output

Il driver restituisce le informazioni SUB_Q_CHANNEL_DATA nel buffer in Irp-AssociatedIrp.SystemBuffer>.

Lunghezza del buffer di output

Lunghezza di un SUB_Q_CHANNEL_DATA.

Blocco dello stato

Il campo Informazioni è impostato sul numero di byte restituiti. Il campo Stato è impostato su STATUS_SUCCESS o eventualmente su 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.

Commenti

A partire da Windows Vista, i driver di classe CDROM non usano questo IOCTL con il membro di formato impostato su IOCTL_CDROM_CURRENT_POSITION. Prima di Windows Vista, questo IOCTL è stato usato per la riproduzione audio nelle unità CD-ROM meno recenti che supportavano l'output audio diretto nell'hardware.

Le applicazioni client devono usare l'API MCI (Media Control Interface) anziché emettere questo IOCTL.

Requisiti

Requisito	Valore
Client minimo supportato	Obsoleto, a partire da Windows Vista.
Intestazione	ntddcdrm.h (include Ntddcdrm.h)

Vedi anche

SUB_Q_CHANNEL_DATA