SET_BAND_METADATA_PARAMETERS結構 （ehstorbandmgmt.h）
已設定的帶狀結構的元數據會設定為 SET_BAND_METADATA_PARAMETERS 結構中的參數。 此結構是 IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA 要求的輸入。
語法
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;
成員
StructSize
這個結構的大小，以位元組為單位。 設定為 sizeof（SET_BAND_METADATA_PARAMETERS）。
BandId
要傳回資訊之單一頻帶的標識碼。 當選取具有 BandId 的單一波段時，BandSize 必須是 0。 若要使用 BandStart 和 BandSize，而不要使用 BandId 來選取樂隊，請將 BandId = （ULONG） –1。
BandStart
存儲設備上的起始位元組位置，以開始進行頻帶搜尋。 嘗試 BandStart之後比對樂隊。
MetadataOffset
頻帶元數據屬性開頭的位移，以設定新的數據。
MetadataSize
要設定的元數據位元組長度。 此大小受限於 MetadataOffset 的值， 從 BAND_MANAGEMENT_CAPABILITIES 結構的 BandMetadataSize 成員減去。
BufferOffset
位移，以位元組為單位，從 SET_BAND_METADATA_PARAMETERS 開頭到新元數據的位置。
AuthKeyOffset
包含頻帶授權金鑰之 AUTH_KEY 結構的位移，以位元組為單位。 位移是從 SET_BAND_METADATA_PARAMETERS開頭。 AUTH_KEY 會在 ehstorbandmgmt.h 中宣告如下。
typedef struct _AUTH_KEY
{
ULONG KeySize;
UCHAR Key[ANYSIZE_ARRAY];
} AUTH_KEY;
KeySize
索引鍵資料的大小，以位元組為單位，位於 Key。 如果 KeySize 設為 0，則會使用預設密鑰。
鑰匙
包含索引鍵數據的可變長度位元組陣列。
若要將預設驗證金鑰指定為頻帶，請設定 AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY。
言論
優先於 BandID 進行頻帶選取。 如果 BandID 大於 0，且 BandID 小於 BAND_MANAGEMENT_CAPABILITIESMaxBandCount 成員，則 BandID 會作為樂隊相符的唯一選取準則。 如果 BandID == -1，則會使用 BandStart 作為選取帶的比對準則。 如果沒有符合任一選取準則的頻帶，則會在 IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA的 IoStatus 區塊中傳回STATUS_INVALID_PARAMETER。
如果 BandID 和 BandStart 都設定為 –1，則 IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA 會設定全域頻帶的元數據。
頻帶元數據存放區的大小位於 BandMetadataSize 中，BAND_MANAGEMENT_CAPABILITIES的成員。 此結構會從 IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES 要求傳回。
要為頻帶設定的新元數據包含在 IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA 要求的系統緩衝區中，並遵循 BufferOffset的這個結構。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 8 開始提供 |
| 標頭 | ehstorbandmgmt.h （include EhStorBandMgmt.h） |