IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS IOCTL (ehstorbandmgmt.h)

  • Artikel

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

IRP_MJ_DEVICE_CONTROL

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

BAND_TABLE

ENUMERATE_BANDS_PARAMETERS