Leggere in inglese

Condividi tramite


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.

Sintassi

HRESULT DirectDrawEnumerateExA(
  [in] LPDDENUMCALLBACKEXA lpCallback,
  [in] LPVOID              lpContext,
  [in] DWORD               dwFlags
);

Parametri

[in] lpCallback

Indirizzo di una funzione DDEnumCallbackEx da chiamare con una descrizione di ogni livello di astrazione hardware abilitato per DirectDraw (HAL) enumerato.

[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.

DDENUM_ATTACHEDSECONDARYDEVICES

La funzione enumera il dispositivo primario e tutti i dispositivi di visualizzazione collegati al desktop.

DDENUM_DETACHEDSECONDARYDEVICES

La funzione enumera il dispositivo primario e tutti i dispositivi di visualizzazione non collegati al desktop.

DDENUM_NONDISPLAYDEVICES

La funzione enumera il dispositivo primario e tutti i dispositivi non di visualizzazione, ad esempio acceleratori 3D che non dispongono di funzionalità 2D.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è DD_OK.

Se ha esito negativo, la funzione restituisce DDERR_INVALIDPARAMS.

Osservazioni

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.

Fabbisogno

Requisito Valore
piattaforma di destinazione Finestre
intestazione ddraw.h
libreria Ddraw.lib
dll Ddraw.dll