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 |