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 |