IOCTL_CDROM_READ_Q_CHANNEL IOCTL (ntddcdrm.h)
Mengembalikan posisi saat ini, katalog media, atau data trek ISRC. Membaca posisi saat ini sudah usang, dimulai dengan Windows Vista.
Kode utama
Buffer input
Buffer di Irp-AssociatedIrp.SystemBuffer> berisi struktur CDROM_SUB_Q_DATA_FORMAT dengan anggota Format diatur ke salah satu hal berikut ini:
IOCTL_CDROM_CURRENT_POSITION
IOCTL_CDROM_MEDIA_CATALOG
IOCTL_CDROM_TRACK_ISRC
Jika Format diatur ke IOCTL_CDROM_TRACK_ISRC, Track harus diatur ke trek yang data ISRCnya diminta.
Panjang buffer input
Panjang Parameters.DeviceIoControl.OutputBufferLength di lokasi tumpukan I/O menunjukkan ukuran, dalam byte, dari buffer, yang harus >= sizeof(SUB_Q_CHANNEL_DATA).
.
Buffer output
Driver mengembalikan informasi SUB_Q_CHANNEL_DATA dalam buffer di Irp-AssociatedIrp.SystemBuffer>.
Panjang buffer output
Panjang SUB_Q_CHANNEL_DATA.
Blok status
Bidang Informasi diatur ke jumlah byte yang dikembalikan. Bidang Status diatur ke STATUS_SUCCESS, atau mungkin ke 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, atau STATUS_VERIFY_REQUIRED.
Keterangan
Dimulai dengan Windows Vista, driver kelas CDROM tidak menggunakan IOCTL ini dengan anggota format diatur ke IOCTL_CDROM_CURRENT_POSITION. Sebelum Windows Vista, IOCTL ini digunakan untuk pemutaran audio pada drive CD-ROM yang lebih lama yang mendukung output audio langsung dalam perangkat keras.
Aplikasi klien harus menggunakan API Media Control Interface (MCI) daripada mengeluarkan IOCTL ini.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Usang, dimulai dengan Windows Vista. |
| Header | ntddcdrm.h (termasuk Ntddcdrm.h) |