struktur SET_BAND_METADATA_PARAMETERS (ehstorbandmgmt.h)
Metadata untuk pita yang dikonfigurasi diatur ke parameter dalam struktur SET_BAND_METADATA_PARAMETERS . Struktur ini adalah input untuk permintaan IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA .
Sintaks
typedef struct _SET_BAND_METADATA_PARAMETERS {
ULONG StructSize;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG MetadataOffset;
ULONG MetadataSize;
ULONG BufferOffset;
ULONG AuthKeyOffset;
} SET_BAND_METADATA_PARAMETERS, *PSET_BAND_METADATA_PARAMETERS;
Anggota
StructSize
Ukuran struktur ini dalam byte. Atur ke sizeof(SET_BAND_METADATA_PARAMETERS).
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.
MetadataOffset
Offset dari awal properti metadata band untuk mengatur data baru.
MetadataSize
Panjang byte metadata yang akan diatur. Ukuran ini dibatasi oleh nilai MetadataOffset yang dikurangi dari anggota BandMetadataSize dari struktur BAND_MANAGEMENT_CAPABILITIES .
BufferOffset
Offset, dalam byte, dari awal SET_BAND_METADATA_PARAMETERS ke lokasi metadata baru.
AuthKeyOffset
Offset, dalam byte, dari struktur AUTH_KEY yang berisi kunci otorisasi untuk pita. Offsetnya adalah dari awal SET_BAND_METADATA_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 AuthKeyOffset = 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_SET_BAND_METADATA.
Jika BandID dan BandStart keduanya diatur ke –1, maka IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA menetapkan metadata untuk band global.
Ukuran penyimpanan metadata pita ditemukan di anggota BandMetadataSizeBAND_MANAGEMENT_CAPABILITIES. Struktur ini dikembalikan dari permintaan IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES .
Metadata baru yang akan diatur untuk band disertakan dalam buffer sistem untuk permintaan IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA dan mengikuti struktur ini di BufferOffset.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia dimulai dengan Windows 8 |
Header | ehstorbandmgmt.h (termasuk EhStorBandMgmt.h) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk