IOCTL_EHSTOR_BANDMGMT_DELETE_BAND IOCTL (ehstorbandmgmt.h)

  • Artikel

Pita yang dikonfigurasi pada perangkat penyimpanan dihapus dengan permintaan IOCTL_EHSTOR_BANDMGMT_DELETE_BAND . Opsi hapus dalam parameter input memungkinkan permintaan untuk melakukan penghapusan kriptografi data band.

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Buffer input di Irp-AssociatedIrp.SystemBuffer> harus berisi DELETE_BAND_PARAMETERS dan mungkin struktur AUTH_KEY.

Jika anggota AuthKeyOffsetDELETE_BAND_PARAMETERS diatur ke EHSTOR_BANDMGR_NO_KEY, data input dalam buffer sistem tidak perlu menyertakan struktur AUTH_KEY .

Panjang buffer input

Parameters.DeviceIoControl.InputBufferLength menunjukkan ukuran, dalam byte, dari buffer, yang harus setidaknya ukuranof (DELETE_BAND_PARAMETERS) + sizeof(AUTH_KEY).

Buffer output

Tidak ada.

Panjang buffer output

Tidak ada.

Blok status

Salah satu nilai berikut ini dapat dikembalikan di bidang Status .

Nilai Status Deskripsi
STATUS_SUCCESS Pita berhasil dihapus.
STATUS_INVALID_DEVICE_REQUEST Perangkat penyimpanan tidak mendukung manajemen pita.
STATUS_INVALID_BUFFER_SIZE Ukuran buffer input salah.
STATUS_INVALID_PARAMETER Informasi dalam buffer input tidak valid.
STATUS_ACCESS_DENIED Kunci autentikasi tidak valid atau pita dikunci untuk penulisan.
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

Kunci autentikasi diperlukan untuk menghapus pita tanpa melakukan penghapusan terlebih dahulu. Untuk meminta penghapusan band, bendera DELBAND_ERASE_BEFORE_DELETE diatur di anggota BenderaDELETE_BAND_PARAMETERS.

Setelah penghapusan band, semua LBA yang terkandung dalam band yang dihapus dikembalikan ke band global. Kondisi penguncian untuk band global sekarang berlaku untuk LBA yang dikembalikan ke band global. LBA yang dikembalikan ke band global sekarang dikaitkan dengan kunci media untuk band global dan data terenkripsi di LBA tersebut tidak dapat dipulihkan.

Pita yang dihapus tetap berada di tabel band driver silo tetapi menjadi tidak dikonfigurasi. Kunci autentikasi diatur ulang ke nilai default, pita, dan metadata kunci berisi nol, dan status kunci kembali ke PERSISTENT_UNLOCK. Pita sekarang tersedia untuk konfigurasi ulang dengan permintaan IOCTL_EHSTOR_BANDMGMT_CREATE_BAND .

Menghapus pita tanpa penghapusan kriptografi tidak akan menghapus kunci enkripsi untuk pita tersebut. Dimungkinkan untuk kemudian membuat pita dengan konfigurasi dan pengidentifikasi band yang sama dengan band yang dihapus. Dalam hal ini, data yang sebelumnya disimpan dalam band dan tidak ditimpa karena penghapusan band sebelumnya akan tersedia. Untuk menghindari situasi ini, hapus pita dengan bendera DELBAND_ERASE_BEFORE_DELETE yang diatur di DELETE_BAND_PARAMETERS.

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND tidak akan menghapus pita global. Permintaan untuk melakukannya akan mengembalikan STATUS_INVALID_PARAMETER.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 8.
Header ehstorbandmgmt.h (termasuk EhStorBandMgmt.h)

Lihat juga

DELETE_BAND_PARAMETERS

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND