Méthode IDirectDraw7::EnumDisplayModes (ddraw.h)

Énumère tous les modes d’affichage exposés par le matériel via l’objet DirectDraw et compatibles avec une description de surface fournie.

Syntaxe

HRESULT EnumDisplayModes(
  [in] DWORD                  unnamedParam1,
  [in] LPDDSURFACEDESC2       unnamedParam2,
  [in] LPVOID                 unnamedParam3,
  [in] LPDDENUMMODESCALLBACK2 unnamedParam4
);

Paramètres

[in] unnamedParam1

Cette valeur se compose d’un ou plusieurs des indicateurs suivants :

DDEDM_REFRESHRATES

Énumère les modes avec différentes fréquences d’actualisation. IDirectDraw7::EnumDisplayModes garantit qu’un mode particulier n’est énuméré qu’une seule fois. Cet indicateur spécifie si la fréquence d’actualisation est prise en compte pour déterminer si un mode est unique.

DDEDM_STANDARDVGAMODES

Énumère le mode 13 en plus du mode X 320x200x8.

[in] unnamedParam2

Adresse d’une structure DDSURFACEDESC2 à vérifier par rapport aux modes disponibles. Si la valeur de ce paramètre est NULL, tous les modes sont énumérés.

[in] unnamedParam3

Adresse d’une structure définie par l’application à passer à chaque membre d’énumération.

[in] unnamedParam4

Adresse de la fonction EnumModesCallback2 que la procédure d’énumération appelle chaque fois qu’une correspondance est trouvée.

Valeur retournée

Si la méthode réussit, la valeur de retour est DD_OK.

En cas d’échec, la méthode peut retourner l’une des valeurs d’erreur suivantes :

• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS

Notes

IDirectDraw7::EnumDisplayModes énumère le membre dwRefreshRate de la structure DDSURFACEDESC2 ; La méthode IDirectDraw::EnumDisplayModes n’a pas cette capacité. Si vous utilisez la méthode IDirectDraw7::SetDisplayMode pour définir la fréquence d’actualisation d’un nouveau mode, utilisez IDirectDraw7::EnumDisplayModes pour énumérer le membre dwRefreshRate .

IDirectDraw7::EnumDisplayModes diffère de ses équivalents dans les anciennes interfaces en ce qu’il accepte l’adresse d’une fonction EnumModesCallback2 en tant que paramètre, plutôt qu’une fonction EnumModesCallback .

Spécifications

Plateforme cible	Windows
En-tête	ddraw.h
Bibliothèque	Ddraw.lib
DLL	Ddraw.dll

Voir aussi

IDirectDraw7