DXGKDDI_RESETENGINE回呼函式 (d3dkmddi.h)
顯示埠驅動程式的 GPU 排程器會呼叫迷你埠驅動程式的 (KMD) DxgkDdiResetEngine 函式,在排程器偵測到適配卡上的逾時條件時,重設實體顯示適配卡上的作用中節點。
語法
DXGKDDI_RESETENGINE DxgkddiResetengine;
NTSTATUS DxgkddiResetengine(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_RESETENGINE pResetEngine
)
{...}
參數
hAdapter
[in]與顯示配接器相關聯的內容區塊句柄。 KMD 先前在 DxgkDdiAddDevice 函式的 MiniportDeviceContext 輸出參數中,將此句柄提供給 Dxgkrnl。
pResetEngine
[in/out] DXGKARG_RESETENGINE 結構,指定要重設的節點,並提供最後一個中止封包的柵欄標識碼。
傳回值
如果函式成功,DxgkDdiResetEngine 會傳回STATUS_SUCCESS。 否則,此函式會傳回 Ntstatus.h 中定義的其中一個錯誤碼。
備註
只有在符合下列所有準則時,KMD 才應該從對此函式的呼叫傳回:
- 重設作業已完成。
- 實體適配卡的硬體佇列中不會有任何保留。
- 指定的節點已準備好接受新的封包。
此函式應該可分頁。
操作系統保證此函式遵循 第一層同步處理模式。
如需詳細資訊,請參閱 Windows 8 中的 TDR 變更。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 |
最低支援的伺服器 | Windows Server 2012 |
目標平台 | 桌面 |
標頭 | d3dkmddi.h |
IRQL | PASSIVE_LEVEL |