PFND3DDDI_CREATECONTEXTCB回调函数 (d3dumddi.h)

Direct3D 运行时的 pfnCreateContextCb 回调函数创建上下文。

语法

PFND3DDDI_CREATECONTEXTCB Pfnd3dddiCreatecontextcb;

HRESULT Pfnd3dddiCreatecontextcb(
  HANDLE hDevice,
  D3DDDICB_CREATECONTEXT *unnamedParam2
)
{...}

参数

hDevice

[in]要为其创建上下文的设备句柄。

unnamedParam2

[in/out]指向驱动程序使用创建上下文所需的信息填充的 D3DDDICB_CREATECONTEXT 结构的指针。 此结构包括节点序号、引擎相关性和标志等详细信息,这些标志指定要创建的上下文的行为和功能。 成功完成后,运行时会更新此结构,其中包含有关新创建的上下文的信息。

返回值

pfnCreateContextCb 返回 HRESULT 以指示上下文创建请求的成功或失败。 常见返回值包括:

返回代码 意义
S_OK 已成功创建上下文。
E_OUTOFMEMORY 内存不足,无法创建上下文。
E_INVALIDARG 提供的一个或多个参数无效。

言论

用户模式显示驱动程序(UMD)必须从其 CreateDevice 实现中显式调用 pfnCreateContextCb,才能创建与设备关联的 GPU 上下文。 GPU 上下文是新创建的设备上的执行 GPU 线程。

上下文封装 GPU 用于执行呈现操作的状态和命令缓冲区。 UMD 负责管理它创建的上下文的生命周期,包括最终销毁以释放资源。

有关创建呈现设备的详细信息,请参阅 Windows 显示驱动程序模型(WDDM)操作流

要求

要求 价值
最低支持的客户端 Windows Vista (WDDM 1.0)
标头 d3dumddi.h

另请参阅

D3DDDICB_CREATECONTEXT

pfnDestroyContextCb