Partager via


PFND3DDDI_QUERYADAPTERINFOCB fonction de rappel (d3dumddi.h)

La fonction pfnQueryAdapterInfoCb récupère les informations de carte graphique.

Syntaxe

PFND3DDDI_QUERYADAPTERINFOCB Pfnd3dddiQueryadapterinfocb;

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

Paramètres

hAdapter

Handle de l’objet adaptateur graphique.

unnamedParam2

pData [in, out]

Pointeur vers une structure D3DDDICB_QUERYADAPTERINFO qui reçoit des informations sur le matériel graphique.

Valeur de retour

pfnQueryAdapterInfoCb retourne l’une des valeurs suivantes :

Retourner le code Description
S_OK Les informations ont été récupérées avec succès.
E_INVALIDARG Les paramètres ont été validés et déterminés comme incorrects.

Cette fonction peut également retourner d’autres valeurs HRESULT.

Remarques

Avant que le runtime Microsoft Direct3D appelle la CreateDevice du pilote d’affichage en mode utilisateur ou fonction CreateDevice(D3D10) pour créer le contexte graphique, le pilote d’affichage en mode utilisateur doit appeler pfnQueryAdapterInfoCb pour récupérer des informations sur le matériel graphique. Cet ordre est particulièrement important pour un système à plusieurs moniteurs.

Dans l’appel pfnQueryAdapterInfoCb, le pilote d’affichage en mode utilisateur envoie une mémoire tampon que le pilote miniport d’affichage remplit avec les données de configuration. Après avoir reçu ces données de configuration, le pilote d’affichage en mode utilisateur peut signaler avec précision ses fonctionnalités lorsque le runtime appelle les fonctions getCaps et GetCaps(D3D10_2) du pilote d’affichage en mode utilisateur. Lorsque le runtime appelle par la suite d’autres fonctions de pilote d’affichage en mode utilisateur spécifiées dans le D3DDDI_DEVICEFUNCS, D3D10DDI_DEVICEFUNCSou D3D11DDI_DEVICEFUNCS structure, le pilote d’affichage en mode utilisateur peut générer des flux de commandes que le matériel peut traiter.

Exemples

L’exemple de code suivant montre comment récupérer des informations sur la carte graphique.

    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;

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
plateforme cible Bureau
d’en-tête d3dumddi.h (include D3dumddi.h)

Voir aussi

CreateDevice

createDevice(D3D10)

D3D10DDI_DEVICEFUNCS

D3D11DDI_DEVICEFUNCS

D3DDDICB_QUERYADAPTERINFO

D3DDDI_ADAPTERCALLBACKS

D3DDDI_DEVICEFUNCS

GetCaps