PFND3DDDI_QUERYADAPTERINFOCB回调函数 (d3dumddi.h)

项目
02/23/2024

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)