PFND3DDDI_QUERYADAPTERINFOCB回调函数（d3dumddi.h）

pfnQueryAdapterInfoCb 函数检索图形适配器信息。

语法

PFND3DDDI_QUERYADAPTERINFOCB Pfnd3dddiQueryadapterinfocb;

HRESULT Pfnd3dddiQueryadapterinfocb(
  HANDLE hAdapter,
  const D3DDDICB_QUERYADAPTERINFO *unnamedParam2
)
{...}

参数

hAdapter

图形适配器对象的句柄。

unnamedParam2

pData [in， out]

指向接收图形硬件相关信息的 D3DDDICB_QUERYADAPTERINFO 结构的指针。

返回值

pfnQueryAdapterInfoCb 返回以下值之一：

返回代码	描述
S_OK	已成功检索信息。
E_INVALIDARG	参数已验证并确定不正确。

此函数还可以返回其他 HRESULT 值。

言论

在 Microsoft Direct3D 运行时调用用户模式显示驱动程序 CreateDevice 或 CreateDevice（D3D10）函数来创建图形上下文之前，用户模式显示驱动程序应调用 pfnQueryAdapterInfoCb 来检索图形硬件的相关信息。此顺序对于多监视器系统尤其重要。

在 pfnQueryAdapterInfoCb 调用中，用户模式显示驱动程序会发送显示微型端口驱动程序填充配置数据的缓冲区。收到此配置数据后，当运行时调用用户模式显示驱动程序 GetCaps 和 GetCaps（D3D10_2）函数时，用户模式显示驱动程序可以准确报告其功能。当运行时随后调用在 D3DDDI_DEVICEFUNCS、D3D10DDI_DEVICEFUNCS或 D3D11DDI_DEVICEFUNCS 结构中指定的其他用户模式显示驱动程序函数时，用户模式显示驱动程序可以生成硬件可以处理的命令流。

例子

下面的代码示例演示如何检索图形适配器信息。

    HRESULT hr;
    // Query for GART segment support
    D3DDDICB_QUERYADAPTERINFO   ddiQueryAdapterInfo;

    memset(&R200AdapterInfo, 0, sizeof(R200AdapterInfo));

    ddiQueryAdapterInfo.pPrivateDriverData = &R200AdapterInfo;
    ddiQueryAdapterInfo.PrivateDriverDataSize = sizeof(R200AdapterInfo);

    hr = m_Callbacks.pfnQueryAdapterInfoCb(m_hAdapter, &ddiQueryAdapterInfo);
    if (FAILED(hr)) {
        return FALSE;
    }

    m_ulGartSupported = R200AdapterInfo.ulGartSupported;

要求

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