PFND3DDDI_QUERYADAPTERINFOCB função de retorno de chamada (d3dumddi.h)

Artigo
02/23/2024

A função pfnQueryAdapterInfoCb recupera informações do adaptador gráfico.

Sintaxe

PFND3DDDI_QUERYADAPTERINFOCB Pfnd3dddiQueryadapterinfocb;

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

Parâmetros

hAdapter

Um identificador para o objeto do adaptador gráfico.

unnamedParam2

pData [in, out]

Um ponteiro para uma estrutura D3DDDICB_QUERYADAPTERINFO que recebe informações sobre o hardware gráfico.

Retornar valor

pfnQueryAdapterInfoCb retorna um dos seguintes valores:

Código de retorno	Descrição
S_OK	As informações foram recuperadas com êxito.
E_INVALIDARG	Os parâmetros foram validados e determinados como incorretos.

Essa função também pode retornar outros valores HRESULT.

Comentários

Antes que o runtime do Microsoft Direct3D chame a função CreateDevice ou CreateDevice(D3D10) do driver de exibição do modo de usuário para criar o contexto gráfico, o driver de exibição do modo de usuário deve chamar pfnQueryAdapterInfoCb para recuperar informações sobre o hardware gráfico. Essa ordem é especialmente importante para um sistema de vários monitores.

Na chamada pfnQueryAdapterInfoCb , o driver de exibição do modo de usuário envia um buffer que o driver de miniporto de exibição preenche com dados de configuração. Depois de receber esses dados de configuração, o driver de exibição do modo de usuário pode relatar com precisão seus recursos quando o runtime chama as funções GetCaps e GetCaps (D3D10_2) do driver de exibição no modo de usuário. Quando o runtime chama posteriormente outras funções de driver de exibição no modo de usuário especificadas na estrutura D3DDDI_DEVICEFUNCS, D3D10DDI_DEVICEFUNCS ou D3D11DDI_DEVICEFUNCS , o driver de exibição no modo de usuário pode gerar fluxos de comando que o hardware pode processar.

Exemplos

O exemplo de código a seguir mostra como recuperar informações do adaptador gráfico.

    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	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	d3dumddi.h (inclua D3dumddi.h)