KeRestoreFloatingPointState 函式 (wdm.h)
KeRestoreFloatingPointState 例程會還原先前呼叫 KeSaveFloatingPointState 所儲存的非浮點內容。
語法
NTSTATUS KeRestoreFloatingPointState(
[in] PKFLOATING_SAVE FloatSave
);
參數
[in] FloatSave
先前呼叫 KeSaveFloatingPointState 中所傳遞之KFLOATING_SAVE結構的指標。
傳回值
KeRestoreFloatingPointState 會傳回STATUS_SUCCESS。
備註
KeRestoreFloatingPointState 是 KeSaveFloatingPointState 的倒數。
任何呼叫 KeSaveFloatingPointState 的例程都必須在該例程傳回控件之前呼叫 KeRestoreFloatingPointState，而且必須在與先前呼叫 KeSaveFloatingPointState 相同的 IRQL 上執行。 不符合上述任一條件會導致系統錯誤檢查。
內核模式驅動程式程式代碼必須確保 對 KeSaveFloatingPointState 和 KeRestoreFloatingPointState 的呼叫已正確巢狀。 這是必要的，如此一來，在每個巢狀層級， KeRestoreFloatingPointState 呼叫所還原的狀態就是對應 KeSaveFloatingPointState 呼叫所儲存的狀態相同。 若要確保適當的巢狀，內核模式驅動程式程式代碼必須遵循下列規則：
- 還原已儲存狀態的 KeRestoreFloatingPointState 呼叫必須與儲存狀態的 KeSaveFloatingPointState 呼叫位於相同的 IRQL 上執行。
- 如果一對 KeSaveFloatingPointState 和 KeRestoreFloatingPointState 呼叫巢狀於一對周圍 KeSaveFloatingPointState 和 KeRestoreFloatingPointState 呼叫內，巢狀呼叫的 IRQL 不得低於周圍呼叫的 IRQL。
- 一般而言，呼叫端配置的 KFLOATING_SAVE 結構包含 KeSaveFloatingPointState 所儲存的狀態位於堆棧上。 堆疊自然會保留已儲存狀態資訊的巢狀結構。 如果驅動程式程式代碼將狀態儲存在堆疊以外的位置，驅動程式寫入器必須特別小心，才能保留 KeSaveFloatingPointState 和 KeRestoreFloatingPointState 呼叫的巢狀。
- 還原已儲存狀態的 KeRestoreFloatingPointState 呼叫必須在與儲存狀態的 KeSaveFloatingPointState 呼叫相同的線程中執行。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 2000 開始提供。 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL (请参阅一节) |