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 結構的長度。
狀態區塊
Information 位元段包含輸出緩衝區中傳回的位元組數目。 下列其中一個值可以在 [狀態] 字段中傳回。
狀態值 | 描述 |
---|---|
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 (include EhStorBandMgmt.h) |