IOCTL_CDROM_READ_Q_CHANNEL IOCTL (ntddcdrm.h)
Gibt die aktuelle Position, den Medienkatalog oder die ISRC-Nachverfolgdaten zurück. Das Lesen der aktuellen Position ist ab Windows Vista veraltet.
Hauptcode
Eingabepuffer
Der Puffer bei Irp-AssociatedIrp.SystemBuffer> enthält eine CDROM_SUB_Q_DATA_FORMAT-Struktur, wobei das Element Format auf eine der folgenden Elemente festgelegt ist:
IOCTL_CDROM_CURRENT_POSITION
IOCTL_CDROM_MEDIA_CATALOG
IOCTL_CDROM_TRACK_ISRC
Wenn Format auf IOCTL_CDROM_TRACK_ISRC festgelegt ist, muss track auf die Spur festgelegt werden, für die ISRC-Daten angefordert werden.
Eingabepufferlänge
Die Länge eines Parameters.DeviceIoControl.OutputBufferLength am E/A-Stapelspeicherort gibt die Größe des Puffers in Bytes an, die = sizeof(SUB_Q_CHANNEL_DATA) sein >muss.
.
Ausgabepuffer
Der Treiber gibt die SUB_Q_CHANNEL_DATA Informationen im Puffer unter Irp-AssociatedIrp.SystemBuffer> zurück.
Länge des Ausgabepuffers
Länge eines SUB_Q_CHANNEL_DATA.
Statusblock
Das Feld Information ist auf die Anzahl der zurückgegebenen Bytes festgelegt. Das Feld Status ist auf STATUS_SUCCESS oder möglicherweise auf 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 oder STATUS_VERIFY_REQUIRED festgelegt.
Hinweise
Ab Windows Vista verwenden Treiber der CDROM-Klasse diese IOCTL nicht, wobei das Formatelement auf IOCTL_CDROM_CURRENT_POSITION festgelegt ist. Vor Windows Vista wurde diese IOCTL für die Audiowiedergabe auf älteren CD-ROM-Laufwerken verwendet, die die direkte Audioausgabe in der Hardware unterstützten.
Clientanwendungen sollten die MCI-API (Media Control Interface) verwenden, anstatt diese IOCTL auszugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Veraltet, beginnend mit Windows Vista. |
| Kopfzeile | ntddcdrm.h (include Ntddcdrm.h) |