Méthode IDirect3D9::EnumAdapterModes (d3d9.h)

Article
08/23/2023

Interroge l’appareil pour déterminer si l’adaptateur spécifié prend en charge le format et le mode d’affichage demandés. Cette méthode peut être utilisée dans une boucle pour énumérer tous les modes d’adaptateur disponibles.

Syntaxe

HRESULT EnumAdapterModes(
  [in]  UINT           Adapter,
  [in]  D3DFORMAT      Format,
  [in]  UINT           Mode,
  [out] D3DDISPLAYMODE *pMode
);

Paramètres

[in] Adapter

Type : UINT

Nombre ordinal indiquant l’adaptateur d’affichage à énumérer. D3DADAPTER_DEFAULT est toujours l’adaptateur d’affichage principal. Cette méthode retourne D3DERR_INVALIDCALL lorsque cette valeur est égale ou supérieure au nombre de cartes d’affichage dans le système.

[in] Format

Type : D3DFORMAT

Formats de pixels autorisés. Consultez la section Notes.

[in] Mode

Type : UINT

Représente l’index en mode d’affichage qui est un entier non signé compris entre zéro et la valeur retournée par GetAdapterModeCount moins un.

[out] pMode

Type : D3DDISPLAYMODE*

Pointeur vers le mode d’affichage disponible de type D3DDISPLAYMODE. Consultez la section Notes.

Valeur de retour

Type : HRESULT

Si l’appareil peut être utilisé sur cette carte, D3D_OK est retourné.
Si l’adaptateur est égal ou supérieur au nombre de cartes d’affichage dans le système, D3DERR_INVALIDCALL est retourné.
Si l’un des formats surface n’est pas pris en charge ou si l’accélération matérielle n’est pas disponible pour les formats spécifiés, D3DERR_NOTAVAILABLE est retourné.

Notes

Une application fournit un mode d’affichage et un format à EnumAdapterModes qui retourne un mode d’affichage. Cette méthode peut être utilisée dans une boucle pour énumérer tous les modes d’affichage disponibles.

L’application spécifie un format et l’énumération est limitée aux modes d’affichage qui correspondent exactement au format (alpha est ignoré). Les formats autorisés (qui sont membres de D3DFORMAT) sont les suivants :

D3DFMT_A1R5G5B5
D3DFMT_A2R10G10B10
D3DFMT_A8R8G8B8
D3DFMT_R5G6B5
D3DFMT_X1R5G5B5
D3DFMT_X8R8G8B8

En outre, EnumAdapterModes traite les formats de pixels 565 et 555 comme équivalents et retourne la version correcte. La différence n’entre en jeu que lorsque l’application verrouille la mémoire tampon arrière et qu’il existe un indicateur explicite que l’application doit définir pour y parvenir.

Spécifications


Plateforme cible	Windows
En-tête	d3d9.h (inclure D3D9.h)
Bibliothèque	D3D9.lib

Voir aussi

IDirect3D9

Share via