PFND3DDDI_QUERYADAPTERINFOCB fonction de rappel (d3dumddi.h)

Article
02/23/2024

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

Syntaxe

PFND3DDDI_QUERYADAPTERINFOCB Pfnd3dddiQueryadapterinfocb;

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

Paramètres

hAdapter

Handle de l’objet d’adaptateur graphique.

unnamedParam2

pData [in, out]

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

Valeur retournée

pfnQueryAdapterInfoCb retourne l’une des valeurs suivantes :

Code de retour	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 n’appelle la fonction CreateDevice ou CreateDevice (D3D10) du pilote d’affichage en mode utilisateur 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 des 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 ensuite d’autres fonctions de pilote d’affichage en mode utilisateur spécifiées dans la structure D3DDDI_DEVICEFUNCS, D3D10DDI_DEVICEFUNCS ou D3D11DDI_DEVICEFUNCS , 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;

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3dumddi.h (inclure D3dumddi.h)