PFND3DDDI_QUERYADAPTERINFOCB función de devolución de llamada (d3dumddi.h)

Artículo
02/23/2024

La función pfnQueryAdapterInfoCb recupera información del adaptador de gráficos.

Sintaxis

PFND3DDDI_QUERYADAPTERINFOCB Pfnd3dddiQueryadapterinfocb;

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

Parámetros

hAdapter

Identificador del objeto de adaptador de gráficos.

unnamedParam2

pData [in, out]

Puntero a una estructura de D3DDDICB_QUERYADAPTERINFO que recibe información sobre el hardware gráfico.

Valor devuelto

pfnQueryAdapterInfoCb devuelve uno de los siguientes valores:

Código devuelto	Descripción
S_OK	La información se recuperó correctamente.
E_INVALIDARG	Los parámetros se validaron y determinaron que son incorrectos.

Esta función también puede devolver otros valores HRESULT.

Comentarios

Antes de que el tiempo de ejecución de Microsoft Direct3D llame a la función CreateDevice o CreateDevice(D3D10) del controlador de pantalla en modo de usuario para crear el contexto de gráficos, el controlador de pantalla en modo de usuario debe llamar a pfnQueryAdapterInfoCb para recuperar información sobre el hardware gráfico. Este orden es especialmente importante para un sistema de varios monitores.

En la llamada pfnQueryAdapterInfoCb , el controlador de pantalla en modo de usuario envía un búfer que el controlador de miniporte de pantalla rellena con datos de configuración. Después de recibir estos datos de configuración, el controlador de pantalla en modo de usuario puede notificar con precisión sus funcionalidades cuando el tiempo de ejecución llama a las funciones GetCaps y GetCaps(D3D10_2) del controlador de pantalla del modo de usuario. Cuando el tiempo de ejecución llama posteriormente a otras funciones del controlador de visualización en modo de usuario que se especifican en el D3DDDI_DEVICEFUNCS, D3D10DDI_DEVICEFUNCS o estructura de D3D11DDI_DEVICEFUNCS , el controlador de pantalla en modo de usuario puede generar flujos de comandos que el hardware puede procesar.

Ejemplos

En el ejemplo de código siguiente se muestra cómo recuperar información del adaptador de gráficos.

    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;

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Escritorio
Encabezado	d3dumddi.h (incluya D3dumddi.h)