KeRestoreExtendedProcessorState 函式 (wdm.h)

  • 發行項

KeRestoreExtendedProcessorState 例程會還原先前儲存的擴充處理器狀態資訊。

語法

void KeRestoreExtendedProcessorState(
  [in] PXSTATE_SAVE XStateSave
);

參數

[in] XStateSave

包含要還原之擴充處理器狀態資訊的 XSTATE_SAVE 結構的指標。 此結構的內容先前必須由 KeSaveExtendedProcessorState 例程儲存。

傳回值

無

備註

內核模式驅動程式程式代碼必須確定 對 KeSaveExtendedProcessorState 和 KeRestoreExtendedProcessorState 的呼叫已正確巢狀。 這是必要的，如此一來，在每個巢狀層級， KeRestoreExtendedProcessorState 呼叫所還原的狀態就是對應 KeSaveExtendedProcessorState 呼叫所儲存的狀態相同。 若要確保適當的巢狀，內核模式驅動程式程式代碼必須遵循下列規則：

  • 還原已儲存狀態的 KeRestoreExtendedProcessorState 呼叫必須與儲存狀態的 KeSaveExtendedProcessorState 呼叫相同 IRQL 執行。
  • 如果一對 KeSaveExtendedProcessorState 和 KeRestoreExtendedProcessorState 呼叫巢狀於一對周圍 KeSaveExtendedProcessorState 和 KeRestoreExtendedProcessorState 呼叫內，巢狀呼叫的 IRQL 不得低於周圍呼叫的 IRQL。
  • 一般而言，呼叫端配置的 XSTATE_SAVE 結構包含 KeSaveExtendedProcessorState 所儲存的狀態位於堆疊上。 堆疊自然會保留已儲存狀態資訊的巢狀結構。 如果驅動程式程式代碼將狀態儲存在堆疊以外的位置，驅動程式寫入器必須特別小心保留 KeSaveExtendedProcessorState 和 KeRestoreExtendedProcessorState 呼叫的巢狀。
  • 還原已儲存狀態的 KeRestoreExtendedProcessorState 呼叫必須在與儲存狀態的 KeSaveExtendedProcessorState 呼叫相同的線程中執行。
類似的規則集適用於 KeSaveFloatingPointState 和 KeRestoreFloatingPointState 例程。

規格需求

需求 值
最低支援的用戶端 適用於 Windows 7 和更新版本的 Windows。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= DISPATCH_LEVEL (请参阅一节)

另請參閱

KeRestoreFloatingPointState

KeSaveExtendedProcessorState

KeSaveFloatingPointState

XSTATE_SAVE