IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA IOCTL (ehstorbandmgmt.h)
Metadata yang terkait dengan band diambil dengan permintaan IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA . Metadata untuk band berfungsi sebagai area data untuk aplikasi manajer kunci.
Kode utama
Buffer input
Buffer input di Irp-AssociatedIrp.SystemBuffer> harus berisi struktur GET_BAND_METADATA_PARAMETERS.
Panjang buffer input
Parameters.DeviceIoControl.InputBufferLength menunjukkan ukuran, dalam byte, dari buffer, yang harus setidaknya berukuranof (GET_BAND_METADATA_PARAMETERS).
Buffer output
Buffer output di Irp-AssociatedIrp.SystemBuffer> berisi array byte metadata band yang ditentukan oleh GET_BAND_METADATA_PARAMETERS.
Panjang buffer output
Panjang struktur GET_BAND_METADATA_PARAMETERS .
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 | Metadata dikembalikan dalam buffer sistem. |
| STATUS_INVALID_DEVICE_REQUEST | Perangkat penyimpanan tidak mendukung manajemen pita. |
| STATUS_INVALID_BUFFER_SIZE | Ukuran buffer output salah. |
| STATUS_INVALID_PARAMETER | Informasi dalam buffer input tidak valid. |
| STATUS_NOT_FOUND | Pita tidak ditemukan untuk kriteria pilihan yang disediakan. |
| STATUS_IO_DEVICE_ERROR | Komunikasi gagal. Perangkat penyimpanan mungkin tidak kompatibel dengan protokol keamanan. |
Keterangan
Autentikasi untuk IOCTL ini tidak perlu dan kunci autentikasi tidak disertakan sebagai input.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia dimulai dengan Windows 8 |
| Header | ehstorbandmgmt.h (termasuk EhStorBandMgmt.h) |