IOCTL_EHSTOR_BANDMGMT_REVERT IOCTL (ehstorbandmgmt.h)

發行項
02/26/2024

此 IOCTL_EHSTOR_BANDMGMT_REVERT 要求會傳送至停用記憶體裝置上的安全性功能和訊號範圍管理。要求包括還原選項和驗證金鑰。

主要程序代碼

輸入緩衝區

Irp-AssociatedIrp.SystemBuffer> 的輸入緩衝區包含ACTIVATE_REVERT_PARAMETERS結構。 ACTIVATE_REVERT_PARAMETERS 在 ehstorbandmgmt.h 中宣告如下。

typedef struct _ACTIVATE_REVERT_PARAMETERS
{
    ULONG           StructSize;
    ULONG           Flags;
    ULONG           AuthKeyOffset;
} ACTIVATE_REVERT_PARAMETERS;

在系統緩衝區中遵循 ACTIVATE_REVERT_PARAMETERS 是 AUTH_KEY 結構。這會保存驗證金鑰的金鑰數據位元組。 AUTH_KEY 在 ehstorbandmgmt.h 中宣告如下。

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

輸入緩衝區長度

ACTIVATE_REVERT_PARAMETERS 結構的長度。

輸出緩衝區

無。

輸出緩衝區長度

無。

狀態區塊

下列其中一個值可以在 [ 狀態 ] 字段中傳回。

狀態值	Description
STATUS_SUCCESS	記憶體裝置上的安全性功能已停用。
STATUS_INVALID_DEVICE_REQUEST	儲存裝置不支援訊號範圍管理。
STATUS_INVALID_BUFFER_SIZE	輸入緩衝區大小無效。
STATUS_INVALID_PARAMETER	輸入緩衝區中的資訊無效。
STATUS_ACCESS_DENIED	驗證金鑰無效。已拒絕停用。
STATUS_DEVICE_CONFIGURATION_ERROR	系統無法以支援的模式設定裝置。
STATUS_IO_DEVICE_ERROR	通訊失敗。存儲設備可能與安全性通訊協定不相容。
STATUS_INVALID_DEVICE_STATE	記憶體裝置未啟動。

備註

從 IOCTL_EHSTOR_BANDMGMT_REVERT 要求成功傳回時，記憶體裝置會回到非使用中的安全性狀態，以及除了 IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES 和 IOCTL_EHSTOR_BANDMGMT_ACTIVATE之外的所有頻外管理 IOCTL 變得無法使用。

規格需求

需求	值
最低支援的用戶端	從 Windows 8 開始提供
標頭	ehstorbandmgmt.h (包含 EhStorBandMgmt.h)

另請參閱

IOCTL_EHSTOR_BANDMGMT_ACTIVATE

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

共用方式為