DXGKDDI_QUERYDEPENDENTENGINEGROUP回呼函式 (d3dkmddi.h)

發行項
02/26/2024

DXGKDDI_QUERYDEPENDENTENGINEGROUP 是由顯示埠驅動程式的 GPU 排程器呼叫，以查詢實體顯示配卡中節點的相依性。

語法

DXGKDDI_QUERYDEPENDENTENGINEGROUP DxgkddiQuerydependentenginegroup;

NTSTATUS DxgkddiQuerydependentenginegroup(
  IN_CONST_HANDLE hAdapter,
  INOUT_DXGKARG_QUERYDEPENDENTENGINEGROUP pQueryDependentEngineGroup
)
{...}

參數

hAdapter

與顯示配接器相關聯的內容區塊句柄。顯示迷你埠驅動程式先前已將此句柄提供給 DxgkDdiAddDevice 函式之 MiniportDeviceContext 輸出參數中的 DirectX 圖形核心子系統。

pQueryDependentEngineGroup

類型 為 DXGKARG_QUERYDEPENDENTENGINEGROUP 的值，指定受重設作業影響的所有節點。

傳回值

如果成功，則傳回STATUS_SUCCESS。否則，它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。

備註

此函式用來描述引擎重設要求所影響的所有實體配接器 (引擎) 。這有助於改善硬體架構上的用戶體驗，這些硬體架構具有多個引擎之間的相依性，而這些引擎可能會影響重設程式。請注意，所有受影響的節點都必須具有相同的引擎親和性值。 (請參閱 Windows 8.) 中 TDR 變更中的引擎親和性討論

顯示埠驅動程式的 GPU 排程器會在每次呼叫 DxgkDdiResetEngine 函式時呼叫 DxgkDdiQueryDependentEngineGroup。 GPU 排程器會等候 500 毫秒，讓顯示迷你埠驅動程式完成所有相依引擎的先佔。對於驅動程式無法完成先佔的任何引擎，GPU 排程器會根據引擎序數值循序呼叫 DxgkDdiResetEngine 函式。

以下是如何在 DXGKARG_QUERYDEPENDENTENGINEGROUP 中計算位掩碼的範例。DependentNodeOrdinalMask 成員。如果 DXGKARG_QUERYDEPENDENTENGINEGROUP 結構 NodeOrdinal 和 EngineOrdinal 成員的原始值為 1 和 0，且具有標識碼 2 和 4 的其他節點也會在重設節點 1 時重設，則驅動程式應該將 DependentNodeOrdinalMask 的二進位值設定為 10110，或以十六進位表示法0x16。系統會假設所有相依節點的索引值 EngineOrdinal 相同。要重設的節點包含在 DependentNodeOrdinalMask 位掩碼中。

此函式應該可分頁，而且一律會成功。

操作系統保證此函式遵循線程和同步處理第一層中所定義的第一層同步處理模式。

如需詳細資訊，請參閱 Windows 8 中的 TDR 變更。