Méthode IDirect3D9 ::GetAdapterIdentifier (d3d9.h)
Décrit les cartes graphiques physiques présentes dans le système lorsque l’interface IDirect3D9 a été instanciée.
Syntaxe
HRESULT GetAdapterIdentifier(
[in] UINT Adapter,
[in] DWORD Flags,
[out] D3DADAPTER_IDENTIFIER9 *pIdentifier
);
Paramètres
[in] Adapter
Type : UINT
Nombre ordinal qui désigne l’adaptateur d’affichage. D3DADAPTER_DEFAULT est toujours l’adaptateur d’affichage principal. La valeur minimale de ce paramètre est 0, et la valeur maximale de ce paramètre est inférieure à la valeur retournée par GetAdapterCount.
[in] Flags
Type : DWORD
Flags définit le membre WHQLLevel de D3DADAPTER_IDENTIFIER9. Les indicateurs peuvent être définis sur 0 ou D3DENUM_WHQL_LEVEL. Si D3DENUM_WHQL_LEVEL est spécifié, cet appel peut se connecter à Internet pour télécharger de nouveaux certificats Microsoft Windows Hardware Quality Labs (WHQL).
Différences entre Direct3D 9 et Direct3D 9Ex :
D3DENUM_WHQL_LEVEL est déconseillé pour Direct3D9Ex exécuté sur Windows Vista, Windows Server 2008, Windows 7 et Windows Server 2008 R2 (ou un système d’exploitation plus actuel). L’un de ces systèmes d’exploitation retourne 1 dans le membre WHQLLevel de D3DADAPTER_IDENTIFIER9 sans vérifier la status du pilote.
[out] pIdentifier
Type : D3DADAPTER_IDENTIFIER9*
Pointeur vers une structure D3DADAPTER_IDENTIFIER9 à remplir avec des informations décrivant cet adaptateur. Si Adapter est supérieur ou égal au nombre d’adaptateurs dans le système, cette structure est mise à zéro.
Valeur retournée
Type : HRESULT
Si la méthode réussit, la valeur de retour est D3D_OK. D3DERR_INVALIDCALL est retourné si l’adaptateur est hors plage, si Flags contient des paramètres non reconnus, ou si pIdentifier a la valeur NULL ou pointe vers la mémoire non réscriptible.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | d3d9.h (inclure D3D9.h) |
| Bibliothèque | D3D9.lib |