IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS IOCTL (ehstorbandmgmt.h)
Permintaan IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS ini dikirim untuk mengambil daftar pita untuk perangkat penyimpanan di bawah manajemen band. Informasi pita dikembalikan dalam tabel entri band yang menyertakan lokasi pita dan properti keamanan.
Kode utama
Buffer input
Buffer di Irp-AssociatedIrp.SystemBuffer> harus berisi struktur ENUMERATE_BANDS_PARAMETERS.
Panjang buffer input
Parameters.DeviceIoControl.InputBufferLength menunjukkan ukuran, dalam byte, dari buffer, yang harus setidaknya ukuranof (ENUMERATE_BANDS_PARAMETERS).
Buffer output
Buffer di Irp-AssociatedIrp.SystemBuffer> berisi struktur BAND_TABLE diikuti dengan entri band BandTableEntryCount.
Panjang buffer output
Panjang struktur BAND_TABLE diikuti oleh entri band BandTableEntryCount .
Blok status
Bidang Informasi berisi jumlah byte yang dikembalikan dalam buffer output. Salah satu nilai berikut ini dapat dikembalikan di bidang Status .
| Nilai Status | Deskripsi |
|---|---|
| STATUS_SUCCESS | Fitur keamanan pada perangkat penyimpanan dinonaktifkan. |
| STATUS_INVALID_DEVICE_REQUEST | Perangkat penyimpanan tidak mendukung manajemen pita. |
| STATUS_INVALID_BUFFER_SIZE | Ukuran buffer input tidak valid. |
| STATUS_INVALID_PARAMETER | Informasi dalam buffer input tidak valid. |
| STATUS_NOT_FOUND | Tidak ada pita yang dikonfigurasi untuk parameter enumerasi yang disediakan. |
| STATUS_BUFFER_OVERFLOW | Buffer tidak disediakan atau ukurannya diatur ke nol. Ukuran yang diperlukan dikembalikan di bidang Informasi . |
| STATUS_IO_DEVICE_ERROR | Komunikasi gagal. Perangkat penyimpanan mungkin tidak kompatibel dengan protokol keamanan. |
| STATUS_BUFFER_TOO_SMALL | Buffer output yang disediakan tidak cukup besar untuk menahan data output yang dikembalikan. |
Keterangan
Driver atau aplikasi dapat mengkueri ukuran buffer output yang diperlukan dengan mengatur buffer output untuk permintaan ke NULL dan ukuran output ke 0. Permintaan IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS akan kembali dengan bidang Status blok IoStatus diatur ke STATUS_BUFFER_OVERFLOW dan bidang Informasi akan berisi ukuran buffer yang diperlukan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia dimulai dengan Windows 8. |
| Header | ehstorbandmgmt.h (termasuk EhStorBandMgmt.h) |
Lihat juga
ENUMERATE_BANDS_PARAMETERS