struktur ERASE_BAND_PARAMETERS (ehstorbandmgmt.h)

Artikel
02/26/2024

Struktur ERASE_BAND_PARAMETERS berisi kriteria pemilihan untuk menghapus pita. Selain itu, kunci autentikasi baru dapat diatur. Struktur ini adalah input untuk permintaan IOCTL_EHSTOR_BANDMGMT_ERASE_BAND .

Sintaks

typedef struct _ERASE_BAND_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         NewAuthKeyOffset;
} ERASE_BAND_PARAMETERS, *PERASE_BAND_PARAMETERS;

Anggota

StructSize

Ukuran struktur ini dalam byte. Atur ke sizeof(ERASE_BAND_PARAMETERS).

Flags

Hapus bendera operasi. Nilai ini adalah kombinasi bitwise OR dari yang berikut ini.

Nilai	Makna
ERASEBAND_AUTHKEY_CACHING_ENABLED	Kunci autentikasi baru untuk pita ini di-cache yang memungkinkan otomatisasi operasi nanti.

Reserved

Dicadangkan.

BandId

Pengidentifikasi satu pita untuk mengembalikan informasi. BandSize harus 0 ketika satu pita dipilih dengan BandId. Untuk menggunakan BandStart dan BandSize alih-alih BandId untuk memilih pita, atur BandId = (ULONG) –1.

BandStart

Lokasi byte awal pada perangkat penyimpanan untuk memulai pencarian band. Upaya dilakukan untuk mencocokkan band pada atau setelah BandStart.

NewAuthKeyOffset

Offset, dalam byte, dari struktur AUTH_KEY yang berisi kunci otorisasi baru untuk pita. Offset berasal dari awal ERASE_BAND_PARAMETERS. AUTH_KEY dinyatakan dalam ehstorbandmgmt.h sebagai berikut.

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

Ukuran Kunci

Ukuran kunci, dalam byte, dari data kunci di Kunci. Jika KeySize diatur ke 0, kunci default akan digunakan.

Kunci

Array byte dengan panjang variabel yang berisi data utama.

Untuk menentukan kunci autentikasi default ke band, atur NewAuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.

Keterangan

Prioritas diberikan kepada BandID untuk pemilihan band. Jika BandID lebih besar dari 0 dan BandID kurang dari anggota MaxBandCountBAND_MANAGEMENT_CAPABILITIES, maka BandID digunakan sebagai satu-satunya kriteria pilihan untuk kecocokan band. Jika BandID == –1, maka BandStart digunakan sebagai kriteria pencocokan untuk memilih pita. Jika tidak ada band yang cocok dengan salah satu kriteria pilihan, STATUS_INVALID_PARAMETER dikembalikan di blok IoStatus untuk IOCTL_EHSTOR_BANDMGMT_ERASE_BAND.