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)