Share via

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

另請參閱

DXGKARG_RESETENGINE

DxgkDdiAddDevice