struktur SET_BAND_LOCATION_PARAMETERS (ehstorbandmgmt.h)

  • Artikel

Struktur SET_BAND_LOCATION_PARAMETERS menentukan parameter untuk mengatur properti lokasi untuk pita pada perangkat penyimpanan untuk permintaan IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION .

Sintaks

typedef struct _SET_BAND_LOCATION_PARAMETERS {
  ULONG         StructSize;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         AuthKeyOffset;
  ULONG         BandLocationInfoOffset;
} SET_BAND_LOCATION_PARAMETERS, *PSET_BAND_LOCATION_PARAMETERS;

Anggota

StructSize

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

BandId

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

BandStart

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

AuthKeyOffset

Offset, dalam byte, dari struktur AUTH_KEY yang berisi kunci otorisasi untuk pita. Offset berasal dari awal SET_BAND_LOCATION_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 panjang variabel yang berisi data kunci.

Untuk menentukan kunci otorisasi default ke band, atur AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.

BandLocationInfoOffset

Offset, dalam byte, dari struktur BAND_LOCATION_INFO . Offset berasal dari awal SET_BAND_LOCATION_PARAMETERS.

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, maka STATUS_INVALID_PARAMETER dikembalikan di blok IoStatus untuk IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION.

Jika BandID dan BandStart diatur ke –1, permintaan IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION akan mengubah properti band global.

Persyaratan

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

Lihat juga

BAND_LOCATION_INFO

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION