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

Vedi anche

IDirectDraw7