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 |