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

另請參閱

DXGKARG_RESETHWENGINE

DxgkDdiResumeHwEngine