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) |