DXGKDDI_CREATECONTEXT回呼函式 (d3dkmddi.h)

  • 發行項

DxgkDdiCreateContext 函式會在 GPU) 內容 (建立圖形處理單位。

語法

DXGKDDI_CREATECONTEXT DxgkddiCreatecontext;

NTSTATUS DxgkddiCreatecontext(
  [in]     IN_CONST_HANDLE hDevice,
  [in/out] INOUT_PDXGKARG_CREATECONTEXT pCreateContext
)
{...}

參數

[in] hDevice

建立新內容的圖形內容裝置句柄。 顯示迷你埠驅動程式的 DxgkDdiCreateDevice 函式先前已將此句柄提供給 DXGKARG_CREATEDEVICE 結構的 hDevice 成員中的 Microsoft DirectX 圖形核心子系統。

[in/out] pCreateContext

包含建立內容相關信息 之DXGKARG_CREATECONTEXT 結構的指標。

傳回值

DxgkDdiCreateContext 會傳回下列其中一個值：

傳回碼 Description
STATUS_SUCCESS DxgkDdiCreateContext 已成功建立內容。
STATUS_NO_MEMORY DxgkDdiCreateContext 無法配置完成所需的記憶體。
STATUS_GRAPHICS_DRIVER_MISMATCH 顯示迷你埠驅動程式與起始對 DxgkDdiCreateContext 呼叫的使用者模式顯示驅動程式不相容。

備註

驅動程式會使用 GPU 內容來保存轉譯狀態的集合。

單一進程可以在指定的裝置上建立多個內容。

驅動程式必須支援任意數目的內容。 驅動程式無法建立內容的唯一有效原因是系統記憶體用盡。

一般而言，每個內容都可以參考先前為擁有該內容之裝置建立的任何資源。

DxgkDdiCreateContext 應該設為可分頁。

規格需求

需求 值
最低支援的用戶端 Windows Vista
目標平台 桌面
標頭 d3dkmddi.h
IRQL PASSIVE_LEVEL

另請參閱

DXGKARG_CREATECONTEXT

DXGKARG_CREATEDEVICE

DxgkDdiCreateDevice