IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL (ehstorbandmgmt.h)

Permintaan IOCTL_EHSTOR_BANDMGMT_ERASE_BAND menghapus dan mengatur ulang kunci autentikasi band secara kriptografis. Konfigurasi band yang tersisa dibiarkan tidak dimodifikasi.

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

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

Jika anggota NewAuthKeyOffsetERASE_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 setidaknya harus sizeof(ERASE_BAND_PARAMETERS) + sizeof(AUTH_KEY).

Buffer output

Tidak ada.

Panjang buffer output

Tidak ada.

Buffer Input/Output

Tidak ada.

Panjang buffer Input/Output

Tidak ada.

Blok status

Salah satu nilai berikut dapat dikembalikan di bidang Status .

Nilai Status	Deskripsi
STATUS_SUCCESS	Band ini 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 penghapusan bukan kunci default dan pita tidak dapat dihapus.
STATUS_NOT_FOUND	Pita tidak ditemukan untuk kriteria pemilihan yang disediakan.
STATUS_IO_DEVICE_ERROR	Komunikasi gagal. Perangkat penyimpanan mungkin tidak kompatibel dengan protokol keamanan.

Keterangan

Kunci autentikasi penghapusan saat ini tidak disediakan dalam permintaan IOCTL_EHSTOR_BANDMGMT_ERASE_BAND . Kunci autentikasi penghapusan untuk perangkat penyimpanan sebelumnya dikonfigurasi.

Tidak ada metode yang disediakan di Windows untuk mengubah kunci autentikasi penghapusan untuk perangkat penyimpanan. Asalkan parameter yang benar diberikan sebagai input dalam buffer sistem, permintaan ini harus berhasil. Jika kunci autentikasi penghapusan diubah di luar Windows, seperti di lingkungan boot ganda dengan sistem operasi yang berbeda, permintaan ini mungkin gagal.

Ketika pita dihapus dengan IOCTL_EHSTOR_BANDMGMT_ERASE_BAND, satu-satunya properti sebelumnya yang tersisa adalah mulai pita dan ukuran pita. Kunci enkripsi media sebelumnya dihapus dan kunci baru dibuat. Penguncian diatur ke PERSISTANT_UNLOCK untuk membaca dan menulis. Metadata keamanan yang sebelumnya diatur dihapus. Kunci autentikasi baru yang ditentukan dalam ERASE_BAND_PARAMETERS diatur kecuali penggunaan kunci default ditunjukkan.

Untuk mencegah aplikasi lain mengontrol pita dan menghapus dengan menggunakan kunci default, kunci autentikasi baru harus disertakan dengan permintaan IOCTL_EHSTOR_BANDMGMT_ERASE_BAND .

Perubahan yang dilakukan pada tabel pita oleh permintaan ini diterapkan pada perangkat secara atomik sebelum permintaan IOCTL selesai. Oleh karena itu, dijamin bahwa pita dimodifikasi dengan semua propertinya ditetapkan atau tidak ada properti yang ditetapkan sama sekali jika terjadi kegagalan sistem atau daya.

Persyaratan

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

Lihat juga

ERASE_BAND_PARAMETERS

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS