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
Buffer di input
Il buffer in corrispondenza di 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 vengono richiesti i dati ISRC.
Lunghezza del buffer di input
La lunghezza di un Parameters.DeviceIoControl.OutputBufferLength nella posizione dello stack di 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 di SUB_Q_CHANNEL_DATA nel buffer in Irp->AssociatedIrp.SystemBuffer.
Lunghezza del buffer di output
Lunghezza di un SUB_Q_CHANNEL_DATA.
Blocco di stato
Il campo Informazioni è impostato sul numero di byte restituiti. Il campo Stato è impostato su STATUS_SUCCESS oppure 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.
Osservazioni
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 su 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Obsoleto, a partire da Windows Vista. |
| intestazione | ntddcdrm.h (include Ntddcdrm.h) |