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 结构。 驱动程序必须使用 UINT 值填充 pData 指向的缓冲区,该值表示设备支持的 D3DDDIFORMAT 图面格式的数目。

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

Simple_instancing

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

要求

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

另请参阅

D3DDDIARG_GETCAPS

D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT

D3DDDIFORMAT

D3DDDI_ADAPTERFUNCS

DDRAW_CAPS