DXGKDDI_SUSPENDCONTEXT回呼函式 (d3dkmddi.h)

DxgkddiSuspendContext 會指示 GPU 暫停內容。 如果 GPU 未認可 TDR 內暫停完成， (逾時偵測和復原) 逾時，OS 將會偵測引擎逾時並執行引擎重設。

語法

DXGKDDI_SUSPENDCONTEXT DxgkddiSuspendcontext;

NTSTATUS DxgkddiSuspendcontext(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_SUSPENDCONTEXT pSuspendContext
)
{...}

參數

hAdapter

[in]要先占並標示為暫停的硬體內容。 這種類型的先佔要求沒有寬限期，而且預期 GPU 會儘快接受。

pSuspendContext

[in]包含此函式其他自變數 之DXGKARG_SUSPENDCONTEXT 結構的指標。

傳回值

如果內容已在呼叫時暫停，DxgkddiSuspendContext 會傳回STATUS_SUCCESS。 否則，這個值會設定為 STATUS_PENDING，當 contextSuspendFence 透過中斷發出訊號時，暫停作業將會完成。

備註

在 DRIVER_INITIALIZATION_DATA 中設定回呼函式，以註冊此回呼函式的實作。

即使 GPU 可以起始迴圈配置資源先佔，但 OS 仍然需要因其他原因而先佔內容的方法;例如，如果需要四處移動其配置，或執行 GPU 電源轉換。

當 OS 暫停內容時，需要內容暫停值來處理案例，不會等待暫停通知、繼續，以及再次暫停內容。 暫停值可讓OS區分先前的暫停通知和最新通知。

一旦暫停內容，就會假設對它的所有參考都會從 GPU 消失，而且 OS 可以自由終結內容或移動其記憶體。 不同於 WDDM 2.3 或更早版本，先前在 DxgkDdiSubmitCommandVirtu) al 中的 ContextSwitch 旗標中沒有個別的 NULL 內容切換命令 (存在於 WDDM 2.4 排程模式中，因為 DxgkddiSuspendContext 應該執行這項工作。

規格需求

另請參閱

DxgkddiResumeContext

DXGKARG_SUSPENDCONTEXT