IOCTL_CDROM_GET_CONFIGURATION IOCTL (ntddcdrm.h)
Meminta informasi fitur dan profil dari perangkat CD-ROM.
Perangkat multimedia memiliki karakteristik yang berbeda tergantung pada jenis media yang ada di perangkat. Untuk memberi driver sarana untuk mengkueri perangkat multimedia tentang berbagai karakteristik ini, spesifikasi SCSI Multimedia - 3 (MMC-3) menentukan perintah yang disebut "GET CONFIGURATION." Perintah ini memungkinkan driver untuk mengkueri perangkat untuk informasi permanen tentang perangkat dan informasi yang bervariasi setiap kali media berubah. Di Microsoft Windows 2000 dan sistem operasi yang lebih baru, driver dapat mengirim kueri ini ke perangkat menggunakan permintaan IOCTL_CDROM_GET_CONFIGURATION.
Permintaan IOCTL_CDROM_GET_CONFIGURATION mengembalikan daftar deskriptor yang menjelaskan kemampuan perangkat untuk media saat ini. Deskriptor ini dibagi menjadi dua grup yang disebut "deskriptor fitur" dan "deskriptor daftar profil." Fitur menentukan kemampuan perangkat dan media terkait. Profil adalah kumpulan fitur. Jika perangkat mendukung profil, perangkat mendukung semua fitur di profil.
Lihat spesifikasi MMC-3 untuk diskusi lebih lanjut mengenai fitur dan profil.
Kode utama
Buffer input
Buffer input.
Panjang buffer input
Parameters.DeviceIoControl.InputBufferLength dalam struktur IO_STACK_LOCATION menunjukkan ukuran, dalam byte, buffer input, yang harus = sizeof(GET_CONFIGURATION_IOCTL_INPUT).
Buffer output
Driver mengembalikan fitur dan data profil di buffer di Irp-AssociatedIrp.SystemBuffer>. Data dimulai dengan header jenis GET_CONFIGURATION_HEADER. Data fitur dilaporkan dalam ruang segera mengikuti header ini. Ukuran dan pemformatannya bergantung pada fitur mana yang dilaporkan.
Panjang buffer output
Parameters.DeviceIoControl.OutputBufferLength di lokasi tumpukan I/O menunjukkan ukuran, dalam byte, buffer, yang harus >= sizeof(GET_CONFIGURATION_HEADER).
Blok status
Bidang Informasi diatur ke jumlah byte yang dikembalikan. Bidang Status diatur ke STATUS_SUCCESS jika permintaan berhasil. Jika Parameters.DeviceIoControl.InputBufferLength tidak memiliki nilai yang benar, permintaan gagal dengan kesalahan STATUS_INFO_LENGTH_MISMATCH. Jika Parameters.DeviceIoControl.OutputBufferLength tidak cukup besar, permintaan gagal dengan kesalahan STATUS_BUFFER_TOO_SMALL. Jika nilai untuk buffer output terlalu besar, permintaan gagal STATUS_INVALID_BUFFER_SIZE pesan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | ntddcdrm.h (termasuk Ntddcdrm.h) |