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 返回以下值之一：

返回代码 说明
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