IOCTL_STORAGE_QUERY_PROPERTY IOCTL (ntddstor.h)
Driver dapat menggunakan IOCTL_STORAGE_QUERY_PROPERTY untuk mengembalikan properti perangkat penyimpanan atau adaptor. Permintaan menunjukkan jenis informasi yang akan diambil, seperti data pertanyaan untuk perangkat atau kemampuan dan batasan adaptor. IOCTL_STORAGE_QUERY_PROPERTY juga dapat digunakan untuk menentukan apakah driver port mendukung properti tertentu atau bidang mana dalam deskriptor properti yang dapat dimodifikasi dengan permintaan properti perubahan berikutnya.
Kode utama
Buffer input
Parameters.DeviceIoControl.InputBufferLength menunjukkan ukuran, dalam byte, dari buffer parameter di Irp-AssociatedIrp.SystemBuffer>, yang harus >= sizeof(STORAGE_PROPERTY_QUERY).
Irp->AssociatedIrp.SystemBuffer berisi STORAGE_PROPERTY_QUERY data yang menentukan apakah akan mengkueri perangkat atau adaptor, jenis kueri yang akan dilakukan, dan parameter tambahan apa pun yang diperlukan untuk kueri, seperti kode halaman untuk halaman pengertian mode SCSI tertentu. Properti perangkat harus diambil hanya dari perangkat; mencoba mengambil properti perangkat dari adaptor akan menyebabkan kesalahan.
Parameters.DeviceIoControl.OutputBufferLength menunjukkan jumlah byte yang dapat ditulis ke Irp-AssociatedIrp.SystemBuffer>. OutputBufferLength dapat berupa nol untuk menentukan apakah properti ada tanpa mengambil datanya.
Panjang buffer input
Parameters.DeviceIoControl.InputBufferLength menunjukkan ukuran, dalam byte, dari buffer parameter di Irp-AssociatedIrp.SystemBuffer>, yang harus >= sizeof(STORAGE_PROPERTY_QUERY).
Buffer output
Driver mengembalikan data kueri ke buffer di Irp-AssociatedIrp.SystemBuffer>. Berbagai jumlah data khusus bus dapat ditambahkan ke struktur.
Panjang buffer output
Transmisikan struktur yang dikembalikan ke STORAGE_DESCRIPTOR_HEADER dan periksa anggota Ukurannya untuk menentukan jumlah byte yang sebenarnya diperlukan struktur.
Blok status
Bidang Informasi diatur ke jumlah byte yang dikembalikan. Bidang Status diatur ke STATUS_SUCCESS, atau mungkin ke STATUS_INVALID_DEVICE_REQUEST, STATUS_INVALID_PARAMETER, atau STATUS_NOT_SUPPORTED.
Persyaratan
Persyaratan | Nilai |
---|---|
Header | ntddstor.h (termasuk Ntddstor.h) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk