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 |