PFND3DDDI_QUERYADAPTERINFOCB funzione di callback (d3dumddi.h)

Articolo
03/08/2023

La funzione pfnQueryAdapterInfoCb recupera informazioni sulla scheda grafica.

Sintassi

PFND3DDDI_QUERYADAPTERINFOCB Pfnd3dddiQueryadapterinfocb;

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

Parametri

hAdapter

Handle per l'oggetto scheda grafica.

unnamedParam2

pData [in, out]

Puntatore a una struttura D3DDDICB_QUERYADAPTERINFO che riceve informazioni sull'hardware grafico.

Valore restituito

pfnQueryAdapterInfoCb restituisce uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	Le informazioni sono state recuperate correttamente.
E_INVALIDARG	I parametri sono stati convalidati e sono stati determinati come non corretti.

Questa funzione potrebbe anche restituire altri valori HRESULT.

Commenti

Prima che il runtime di Microsoft Direct3D chiami la funzione CreateDevice o CreateDevice(D3D10) del driver di visualizzazione in modalità utente per creare il contesto grafico, il driver di visualizzazione in modalità utente deve chiamare pfnQueryAdapterInfoCb per recuperare informazioni sull'hardware grafico. Questo ordine è particolarmente importante per un sistema di monitoraggio multiplo.

Nella chiamata pfnQueryAdapterInfoCb , il driver di visualizzazione in modalità utente invia un buffer che il driver miniport visualizzato riempie con i dati di configurazione. Dopo aver ricevuto questi dati di configurazione, il driver di visualizzazione in modalità utente può segnalare con precisione le relative funzionalità quando il runtime chiama le funzioni GetCaps e GetCaps (D3D10_2) del driver di visualizzazione in modalità utente. Quando il runtime chiama successivamente altre funzioni del driver di visualizzazione in modalità utente specificate nella struttura D3DDDI_DEVICEFUNCS, D3D10DDI_DEVICEFUNCS o D3D11DDI_DEVICEFUNCS , il driver di visualizzazione in modalità utente può generare flussi di comando che l'hardware può elaborare.

Esempio

Nell'esempio di codice seguente viene illustrato come recuperare informazioni sulla scheda grafica.

    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;

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	d3dumddi.h (include D3dumddi.h)