共用方式為

KeRestoreExtendedProcessorState 函式 （wdm.h）

  • 發行項

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

語法

void KeRestoreExtendedProcessorState(
  [in] PXSTATE_SAVE XStateSave
);

參數

[in] XStateSave

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

傳回值

沒有

言論

內核模式驅動程式程式代碼必須確保呼叫 KeSaveExtendedProcessorState，且 KeRestoreExtendedProcessorState 已正確巢狀。 這是必要的，因此，在每個巢狀層級，KeRestoreExtendedProcessorState 呼叫所還原的狀態與對應 KeSaveExtendedProcessorState 呼叫所儲存的狀態相同。 為了確保適當的巢狀結構，內核模式驅動程式程式代碼必須遵循下列規則：

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

要求

要求 價值
最低支援的用戶端 適用於 Windows 7 和更新版本的 Windows。
目標平臺 普遍
標頭 wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h）
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL （請參閱一節）

另請參閱

KeRestoreFloatingPointState

KeSaveExtendedProcessorState

KeSaveFloatingPointState

XSTATE_SAVE