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

Voir aussi

GetAdapterCount

IDirect3D9