Metodo IDirectDraw7::EnumDisplayModes (ddraw.h)
Enumera tutte le modalità di visualizzazione esposte dall'hardware tramite l'oggetto DirectDraw e compatibili con una descrizione della superficie specificata.
Sintassi
HRESULT EnumDisplayModes(
[in] DWORD unnamedParam1,
[in] LPDDSURFACEDESC2 unnamedParam2,
[in] LPVOID unnamedParam3,
[in] LPDDENUMMODESCALLBACK2 unnamedParam4
);
Parametri
[in] unnamedParam1
Questo valore è costituito da uno o più flag seguenti:
DDEDM_REFRESHRATES
Enumera le modalità con frequenze di aggiornamento diverse. IDirectDraw7::EnumDisplayModes garantisce che una particolare modalità venga enumerata una sola volta. Questo flag specifica se la frequenza di aggiornamento viene presa in considerazione quando si determina se una modalità è univoca.
DDEDM_STANDARDVGAMODES
Enumera la modalità 13 oltre alla modalità X 320x200x8.
[in] unnamedParam2
Indirizzo di una struttura DDSURFACEDESC2 da controllare in base alle modalità disponibili. Se il valore di questo parametro è NULL, vengono enumerate tutte le modalità.
[in] unnamedParam3
Indirizzo di una struttura definita dall'applicazione da passare a ogni membro di enumerazione.
[in] unnamedParam4
Indirizzo della funzione EnumModesCallback2 che la routine di enumerazione chiama ogni volta che viene trovata una corrispondenza.
Valore restituito
Se il metodo ha esito positivo, il valore restituito viene DD_OK.
Se ha esito negativo, il metodo può restituire uno dei valori di errore seguenti:
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
Commenti
IDirectDraw7::EnumDisplayModes enumera il membro dwRefreshRate della struttura DDSURFACEDESC2 ; Il metodo IDirectDraw::EnumDisplayModes non dispone di questa funzionalità. Se si usa il metodo IDirectDraw7::SetDisplayMode per impostare la frequenza di aggiornamento di una nuova modalità, utilizzare IDirectDraw7::EnumDisplayModes per enumerare il membro dwRefreshRate .
IDirectDraw7::EnumDisplayModes differisce dalle relative interfacce precedenti in quanto accetta l'indirizzo di una funzione EnumModesCallback2 come parametro, anziché come funzione EnumModesCallback .
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | ddraw.h |
| Libreria | Ddraw.lib |
| DLL | Ddraw.dll |