IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES IOCTL (ehstorbandmgmt.h)
IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES要求會擷取存儲設備的帶狀安全性功能。 IOCTL 會將功能當做系統緩衝區中的 BAND_MANAGEMENT_CAPABILITIES 結構傳回。
主要程序代碼
輸入緩衝區
無。
輸入緩衝區長度
無。
輸出緩衝區
Irp-AssociatedIrp.SystemBuffer> 的輸出緩衝區包含BAND_MANAGEMENT_CAPABILITIES結構。
輸出緩衝區長度
BAND_MANAGEMENT_CAPABILITIES 結構的長度。
狀態區塊
[資訊] 欄位包含輸出緩衝區中傳回的位元組數目。 下列其中一個值可以在 [ 狀態 ] 字段中傳回。
| 狀態值 | Description |
|---|---|
| STATUS_SUCCESS | 裝置支援頻外管理，而安全性功能會在系統緩衝區中傳回。 |
| STATUS_INVALID_DEVICE_REQUEST | 儲存裝置不支援頻外管理。 |
| STATUS_INVALID_DEVICE_STATE | 裝置提供頻外管理支援，但不會在其目前設定中提供。 |
| STATUS_BUFFER_OVERFLOW | 未提供緩衝區，或其大小設定為零。 必要大小會在 [ 資訊 ] 欄位中傳回。 |
| STATUS_BUFFER_TOO_SMALL | 緩衝區大小太小而無法傳回輸出。 |
備註
驅動程式或應用程式可以將要求的輸出緩衝區設定為 NULL，並將輸出大小設定為 0，以查詢必要的輸出緩衝區大小。 IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES要求會傳回IoStatus區塊的 [狀態] 字段設為 [STATUS_BUFFER_OVERFLOW]，而 [資訊] 字段將會包含所需的緩衝區大小。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 8 開始提供 |
| 標頭 | ehstorbandmgmt.h (包括 EhStorBandMgmt.h) |