Funzione DirectDrawEnumerateExA (ddraw.h)
Enumera tutti i dispositivi DirectDraw installati nel computer. La voce NULL identifica sempre il dispositivo di visualizzazione primario condiviso con GDI.
HRESULT DirectDrawEnumerateExA(
[in] LPDDENUMCALLBACKEXA lpCallback,
[in] LPVOID lpContext,
[in] DWORD dwFlags
);
[in] lpCallback
Indirizzo di una funzione DDEnumCallbackEx
[in] lpContext
Indirizzo di un valore definito dall'applicazione da passare alla funzione di callback di enumerazione ogni volta che viene chiamata.
[in] dwFlags
Flag che specificano l'ambito di enumerazione. Questo parametro può essere 0 o una combinazione dei flag seguenti. Se il valore è 0, la funzione enumera solo il dispositivo di visualizzazione primario.
La funzione enumera il dispositivo primario e tutti i dispositivi di visualizzazione collegati al desktop.
La funzione enumera il dispositivo primario e tutti i dispositivi di visualizzazione non collegati al desktop.
La funzione enumera il dispositivo primario e tutti i dispositivi non di visualizzazione, ad esempio acceleratori 3D che non dispongono di funzionalità 2D.
Se la funzione ha esito positivo, il valore restituito è DD_OK.
Se ha esito negativo, la funzione restituisce DDERR_INVALIDPARAMS.
Nei computer con più monitor, DirectDrawEnumerateEx enumera più dispositivi di visualizzazione.
È necessario usare LoadLibrary per collegare in modo esplicito a Ddraw.dll. Per recuperare l'indirizzo della funzione DirectDrawEnumerateEx, chiamare la funzione GetProcAddress Win32 con le stringhe dei nomi del processo "DirectDrawEnumerateExA" (ANSI) o "DirectDrawEnumerateExW" (Unicode).
Nota
L'intestazione ddraw.h definisce DirectDrawEnumerateEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Requisito | Valore |
---|---|
piattaforma di destinazione | Finestre |
intestazione |
ddraw.h |
libreria |
Ddraw.lib |
dll | Ddraw.dll |