IOCTL_EHSTOR_BANDMGMT_REVERT IOCTL (ehstorbandmgmt.h)

Artikel
02/26/2024

Permintaan IOCTL_EHSTOR_BANDMGMT_REVERT ini dikirim untuk menonaktifkan fitur keamanan dan manajemen pita pada perangkat penyimpanan. Permintaan ini mencakup opsi kembalikan dan kunci autentikasi.

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Buffer input di Irp-AssociatedIrp.SystemBuffer> berisi struktur ACTIVATE_REVERT_PARAMETERS. ACTIVATE_REVERT_PARAMETERS dinyatakan dalam ehstorbandmgmt.h sebagai berikut.

typedef struct _ACTIVATE_REVERT_PARAMETERS
{
    ULONG           StructSize;
    ULONG           Flags;
    ULONG           AuthKeyOffset;
} ACTIVATE_REVERT_PARAMETERS;

Mengikuti ACTIVATE_REVERT_PARAMETERS dalam buffer sistem adalah struktur AUTH_KEY . Ini menyimpan byte data utama untuk kunci autentikasi. AUTH_KEY dinyatakan dalam ehstorbandmgmt.h sebagai berikut.

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

Panjang buffer input

Panjang struktur ACTIVATE_REVERT_PARAMETERS .

Buffer output

Tidak ada.

Panjang buffer output

Tidak ada.

Blok status

Salah satu nilai berikut 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_ACCESS_DENIED	Kunci autentikasi tidak valid. Pennonaktifkanan ditolak.
STATUS_DEVICE_CONFIGURATION_ERROR	Sistem tidak dapat mengonfigurasi perangkat dalam mode yang didukung.
STATUS_IO_DEVICE_ERROR	Komunikasi gagal. Perangkat penyimpanan mungkin tidak kompatibel dengan protokol keamanan.
STATUS_INVALID_DEVICE_STATE	Perangkat penyimpanan tidak diaktifkan.

Keterangan

Pada pengembalian yang berhasil dari permintaan IOCTL_EHSTOR_BANDMGMT_REVERT , perangkat penyimpanan akan kembali ke status keamanan yang tidak aktif dan semua IOCTL manajemen pita, kecuali untuk IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES dan IOCTL_EHSTOR_BANDMGMT_ACTIVATE, menjadi tidak tersedia.

Persyaratan

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

Lihat juga

IOCTL_EHSTOR_BANDMGMT_ACTIVATE

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

Bagikan melalui