IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA IOCTL (ehstorbandmgmt.h)
與訊號範圍相關聯的元數據會以 IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA 要求擷取。 訊號區的元數據可作為金鑰管理員應用程式的數據區域。
主要程序代碼
輸入緩衝區
Irp-AssociatedIrp.SystemBuffer> 的輸入緩衝區必須包含GET_BAND_METADATA_PARAMETERS結構。
輸入緩衝區長度
Parameters.DeviceIoControl.InputBufferLength 指出緩衝區的大小，以位元組為單位，這至少必須是 大小of (GET_BAND_METADATA_PARAMETERS) 。
輸出緩衝區
Irp-AssociatedIrp.SystemBuffer> 的輸出緩衝區包含GET_BAND_METADATA_PARAMETERS所指定之帶元數據的位元組陣列。
輸出緩衝區長度
GET_BAND_METADATA_PARAMETERS 結構的長度。
狀態區塊
[資訊] 欄位包含輸出緩衝區中傳回的位元組數目。 下列其中一個值可以在 [ 狀態 ] 字段中傳回。
| 狀態值 | Description |
|---|---|
| STATUS_SUCCESS | 元數據是在系統緩衝區中傳回。 |
| STATUS_INVALID_DEVICE_REQUEST | 儲存裝置不支援頻外管理。 |
| STATUS_INVALID_BUFFER_SIZE | 輸出緩衝區大小不正確。 |
| STATUS_INVALID_PARAMETER | 輸入緩衝區中的資訊無效。 |
| STATUS_NOT_FOUND | 找不到所提供選取準則的訊號範圍。 |
| STATUS_IO_DEVICE_ERROR | 通訊失敗。 儲存裝置可能與安全性通訊協定不相容。 |
備註
此 IOCTL 的驗證是不必要的，而且不會包含驗證金鑰作為輸入。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 8 開始提供 |
| 標頭 | ehstorbandmgmt.h (包括 EhStorBandMgmt.h) |