PFND3DDDI_CREATEDEVICE回调函数 (d3dumddi.h)

CreateDevice 函数创建在后续调用中引用的图形上下文。

语法

PFND3DDDI_CREATEDEVICE Pfnd3dddiCreatedevice;

HRESULT Pfnd3dddiCreatedevice(
  HANDLE hAdapter,
  D3DDDIARG_CREATEDEVICE *unnamedParam2
)
{...}

参数

hAdapter

标识图形适配器的句柄。

unnamedParam2

pCreateData [in, out]

指向 D3DDDIARG_CREATEDEVICE 结构的指针。 在输入时,此结构包含驱动程序可以使用的信息。 在输出中,驱动程序指定 Microsoft Direct3D 运行时可以使用的结构中的信息。

返回值

CreateDevice 返回以下值之一:

返回代码 说明
S_OK 已成功创建图形上下文。
E_OUTOFMEMORY CreateDevice 无法分配完成所需的内存。

言论

显示设备是用于保存呈现状态集合的图形上下文。 可以在给定适配器上由同一进程创建多个设备。 请注意,可同时存在的显示设备数仅受可用系统内存的限制。 也就是说,驱动程序无法硬编码最大设备限制。

通常,设备彼此独立,因此无法引用或访问在一台设备中创建的资源。 但是,跨进程资源是此规则的例外。

当 Direct3D 运行时调用 CreateDevice 创建设备时,运行时不会为设备创建默认的图形处理单元(GPU)上下文线程。 驱动程序必须显式调用 pfnCreateContextCb 函数才能根据需要创建一个或多个上下文。

要求

要求 价值
最低支持的客户端 在 Windows Vista 和更高版本的 Windows作系统中可用。
目标平台 桌面
标头 d3dumddi.h (包括 D3dumddi.h)

另请参阅

D3DDDIARG_CREATEDEVICE

D3DDDI_ADAPTERFUNCS

DestroyDevice