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) |