DXGKDDI_RESETHWENGINE回呼函式 (d3dkmddi.h)
Dxgkrnl 會在需要 GPU 引擎重設時呼叫顯示迷你埠驅動程式的 (KMD) DxgkDdiResetHwEngine 函式。
語法
DXGKDDI_RESETHWENGINE DxgkddiResethwengine;
NTSTATUS DxgkddiResethwengine(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_RESETHWENGINE pResetHwEngine
)
{...}
參數
hAdapter
[in]與顯示配接器相關聯的內容區塊句柄。 KMD 先前在 DxgkDdiAddDevice 函式的 MiniportDeviceContext 輸出參數中，將此句柄提供給 Dxgkrnl。
pResetHwEngine
[in/out] DXGKARG_RESETHWENGINE 結構的指標，其中包含重設硬體引擎的資訊。
傳回值
如果作業成功，DxgkDdiResetHwEngine 會傳回STATUS_SUCCESS。 否則，它應該會傳回適當的NTSTATUS錯誤碼。
備註
DxgkDdiResetHwEngine 實作應該呼叫 DxgkCbInvalidateHwContext 回呼，以通知操作系統所有受 GPU 引擎重設作業影響的內容。 OS 會將這些內容裝置失效， (錯誤設定為錯誤) ，且不會執行未來的提交。
呼叫 DxgkDdiResetHwEngine 之後，引擎不會被視為繼續，因此不允許提交未失效的內容。 OS 必須重新啟用來自此引擎的中斷，並將其狀態與重設 GPU 引擎同步處理。 之後，OS 會啟用中斷並呼叫 DxgkDdiResumeHwEngine，這會指示 GPU 引擎開始排程不受引擎重設影響的所有可執行內容。
在 **DRIVER_INITIALIZATION_DATA ** 結構中註冊此回呼函式的實作。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 版本 1703 (WDDM 2.2) |
| 標頭 | d3dkmddi.h |