IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ IOCTL (ehstorioctl.h)
IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ 是由增強型記憶體類別驅動程式 (EHSTOR) 傳送至尋址接收器驅動程式,以起始隨選驗證或取消驗證。
主要程序代碼
輸入緩衝區
Irp->AssociatedIrp.SystemBuffer 的輸入緩衝區必須包含 AUTHZ_STATE 結構,指出要執行的驗證作業類型。 AUTHZ_STATE 會在 ehstorioctl.h 中宣告為下列專案。
typedef struct _AUTHZ_STATE
{
ULONG AuthzState;
} AUTHZ_STATE;
AuthzState 的值會指定驗證作業。 這是下列其中一項。
價值 | 描述 |
---|---|
0 | 執行隨選驗證。 |
AUTHZSTATE_AUTHENTICATE | 執行隨選驗證。 |
AUTHZSTATE_CLEAR_AUTHKEY_CACHE | 執行隨選取消驗證,並清除快取的驗證金鑰。 |
輸入緩衝區長度
AUTHZ_STATE 結構的長度。
輸出緩衝區
沒有。
輸出緩衝區長度
沒有。
狀態區塊
如果驗證狀態變更,STATUS_SUCCESS會在尋址接收器驅動程式的 [狀態] 字段中傳回STATUS_SUCCESS。 否則會傳回STATUS_UNSUCCESSFUL。
言論
此 IOCTL 是由 EHSTOR 傳送至支援隨選驗證的尋址接收器驅動程式。 尋址接收器驅動程式會在先前的 IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES 要求中通知 EHSTOR 這項功能,並在 SILO_DRIVER_CAPABILITES的 功能 成員中設定 CAP_ON_DEMAND_AUTHENTICATION 旗標。
為了回應此 IOCTL,尋址接收器驅動程式會執行裝置的驗證或取消驗證。 針對帶狀裝置,尋址接收器驅動程式會根據系統緩衝區中指定的作業,盡可能解除鎖定或鎖定讀取和寫入的頻帶數目。
如果尋址接收器驅動程式無法執行要求的作業,它將不會變更裝置的驗證狀態。
如果 AUTHZ_STATE 的 AuthzState 成員設定為 AUTHZSTATE_CLEAR_AUTHKEY_CACHE,則尋址接收器驅動程式除了取消驗證之外,也會清除其驗證密鑰快取。 當系統關閉或休眠時,會設定 AUTHZSTATE_CLEAR_AUTHKEY_CACHE。 這可防止在休眠檔案中出現索引鍵快取。
如果裝置支援多個尋址接收器,則每個尋址接收器的驗證都是獨佔的。 一個尋址接收器驅動程式的驗證作業不會影響另一個尋址接收器驅動程式所設定的驗證狀態。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows 8 開始提供 |
標頭 | ehstorioctl.h (包括 EhStorIoctl.h) |