GET_BAND_METADATA_PARAMETERS 結構 (ehstorbandmgmt.h)
根據 GET_BAND_METADATA_PARAMETERS 結構中的參數，擷取已設定的頻外元數據。 這個結構是 IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA 要求的輸入。
語法
typedef struct _GET_BAND_METADATA_PARAMETERS {
ULONG StructSize;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG MetadataOffset;
ULONG MetadataSize;
} GET_BAND_METADATA_PARAMETERS, *PGET_BAND_METADATA_PARAMETERS;
成員
StructSize
這個結構的大小，以位元組為單位。 設定為 sizeof (GET_BAND_METADATA_PARAMETERS) 。
BandId
要傳回資訊之單一訊號段的標識碼。 當使用 BandId 選取單一帶時，BandSize 必須是 0。若要使用 BandStart 和 BandSize 而非 BandId 來選取訊號，請將 BandId = (ULONG) –1。
BandStart
儲存裝置上的起始位元組位置，以開始進行頻外搜尋。 嘗試比對 BandStart 或之後的帶狀。
MetadataOffset
要從帶狀區元數據屬性開頭擷取數據的位移。
MetadataSize
要擷取的元數據位元組長度。
備註
優先順序會指定給 BandID 進行頻 外選取。 如果 BandID 大於 0 且 BandID 小於BAND_MANAGEMENT_CAPABILITIES的 MaxBandCount 成員，則 BandID 會當做頻形比對的唯一選取準則使用。 如果 BandID == –1， 則 BandStart 會作為比對準則來選取帶狀。 如果沒有符合任一選取準則的訊號範圍，則會在 IoStatus 區塊中傳回 IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA STATUS_INVALID_PARAMETER。
如果 BandID 和 BandStart 都設定為 –1， 則IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA 會傳回全域頻的元數據。
如果 IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA 成功， Parameters.DeviceIoControl.InputBufferLength 等於 MetadataSize 中的值。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 8 開始提供 |
| 標頭 | ehstorbandmgmt.h (包括 EhStorBandMgmt.h) |