PFND3DDDI_GETCAPS回调函数 (d3dumddi.h)

D3D 运行时调用驱动程序的 PFND3DDDI_GETCAPS 回调函数来查询图形适配器的功能。

语法

PFND3DDDI_GETCAPS Pfnd3dddiGetcaps;

HRESULT Pfnd3dddiGetcaps(
  HANDLE hAdapter,
  const D3DDDIARG_GETCAPS *unnamedParam2
)
{...}

参数

hAdapter

标识图形适配器的句柄。

unnamedParam2

pData [in, out]

指向描述要检索的功能 的 D3DDDIARG_GETCAPS 结构的指针。

返回值

PFND3DDDI_GETCAPS 返回以下值之一:

返回代码 说明
S_OK 已成功检索功能。
E_OUTOFMEMORY PFND3DDDI_GETCAPS无法分配完成所需的内存。

注解

在 D3DDDIARG_GETCAPS 结构的 pData 成员中返回的数据取决于 (请求的数据类型,即数据依赖于D3DDDIARG_GETCAPS。键入 ,有时在 pInfo 成员) 。

下表有两个示例,说明如何根据 D3DDDIARG_GETCAPS 的值设置 PFND3DDDI_GETCAPS调用。类型

D3DDDIARG_GETCAPS 成员 示例 1 示例 2
类型 D3DDDICAPS_DDRAW D3DDDICAPS_GETFORMATCOUNT
pInfo [in]NULL (未设置任何条件) [in]NULL (未设置任何条件)
pData [out] DDRAW_CAPS (唯一指针) [out]UINT* (唯一指针)
DataSize sizeof (DDRAW_CAPS) sizeof (UINT)
备注 驱动程序必须使用它支持的 DirectDraw 功能填充 DDRAW_CAPS 结构。 驱动程序必须使用表示设备支持的D3DDDIFORMAT图面格式数的 UINT 值填充 pData 指向的缓冲区。

有关 D3DDDIARG_GETCAPS 的其他值的说明,请参阅 D3DDDIARG_GETCAPS。 用于多平面覆盖的类型。

Simple_instancing

如果支持 Windows 显示驱动程序模型 (WDDM) 1.3 及更高版本的 Direct3D 级别 9 驱动程序完成 对 PFND3DDDI_GETCAPS 的调用并返回S_OK但不更改 D3DDDIARG_GETCAPS 结构中的数据,则它向 Direct3D 运行时指示硬件和驱动程序不支持简单的实例化。 有关详细信息,请参阅 D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT

要求

要求
最低受支持的客户端 Windows Vista
目标平台 桌面
标头 d3dumddi.h (包括 D3dumddi.h)

另请参阅

D3DDDIARG_GETCAPS

D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT

D3DDDIFORMAT

D3DDDI_ADAPTERFUNCS

DDRAW_CAPS