IOCTL_EHSTOR_BANDMGMT_ACTIVATE IOCTL (ehstorbandmgmt.h)

  • Artikel

Permintaan IOCTL_EHSTOR_BANDMGMT_ACTIVATE ini dikirim untuk mengaktifkan fitur keamanan dan manajemen band pada perangkat penyimpanan. Permintaan ini mencakup opsi aktivasi 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 ini dapat dikembalikan di bidang Status .

Nilai Status Deskripsi
STATUS_SUCCESS Fitur keamanan pada perangkat penyimpanan diaktifkan.
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. Aktivasi 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 sudah diaktifkan.
STATUS_NOT_SUPPORTED Fitur keamanan pada perangkat tidak diaktifkan karena pengaturan Kebijakan Grup.

Keterangan

Jika STATUS_SUCCESS dikembalikan dari permintaan ini, driver atau aplikasi kemudian dapat mengirim permintaan IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES untuk mengambil kemampuan manajemen band yang diaktifkan dari perangkat.

Sebelum berhasil mengembalikan dari IOCTL_EHSTOR_BANDMGMT_ACTIVATE, perangkat tidak diaktifkan. Hingga perangkat diaktifkan, satu-satunya IOCTL manajemen band yang akan berhasil dikembalikan adalah IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES. Setelah aktivasi, IOCTL manajemen band yang tersisa tersedia.

Aktivasi perangkat Enhanced Storage dikendalikan oleh pengaturan Kebijakan Grup sistem. Nilai registri di HKLM\Software\Policies\Microsoft\Windows\EnhancedStorageDevices\TCGSecurityActivationDisabled menentukan apakah aktivasi keamanan diaktifkan. Nilai REG_DWORD 0 memungkinkan aktivasi keamanan pada perangkat penyimpanan. Jika tidak, nilai 1 menonaktifkan aktivasi keamanan dan permintaan IOCTL_EHSTOR_BANDMGMT_ACTIVATE akan kembali dengan STATUS_NOT_SUPPORTED.

Persyaratan

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

Lihat juga

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_REVERT