Auf Englisch lesen

Freigeben über


DirectDrawEnumerateExW-Funktion (ddraw.h)

Listet alle DirectDraw-Geräte auf, die auf dem Computer installiert sind. Der NULL-Eintrag identifiziert immer das primäre Anzeigegerät, das für GDI freigegeben ist.

Syntax

HRESULT DirectDrawEnumerateExW(
  [in] LPDDENUMCALLBACKEXW lpCallback,
  [in] LPVOID              lpContext,
  [in] DWORD               dwFlags
);

Parameter

[in] lpCallback

Adresse einer DDEnumCallbackEx--Funktion, die mit einer Beschreibung der einzelnen aufgezählten DirectDraw-fähigen Hardwarestraktionsebenen (HAL) aufgerufen werden soll.

[in] lpContext

Adresse eines anwendungsdefinierten Werts, der bei jedem Aufruf an die Enumerationsrückruffunktion übergeben werden soll.

[in] dwFlags

Flags, die den Enumerationsbereich angeben. Dieser Parameter kann 0 oder eine Kombination der folgenden Flags sein. Wenn der Wert 0 ist, listet die Funktion nur das primäre Anzeigegerät auf.

DDENUM_ATTACHEDSECONDARYDEVICES

Die Funktion listet das primäre Gerät und alle Anzeigegeräte auf, die an den Desktop angeschlossen sind.

DDENUM_DETACHEDSECONDARYDEVICES

Die Funktion listet das primäre Gerät und alle Anzeigegeräte auf, die nicht an den Desktop angeschlossen sind.

DDENUM_NONDISPLAYDEVICES

Die Funktion listet das primäre Gerät und alle Nichtanzeigegeräte auf, z. B. 3D-Zugriffstasten ohne 2D-Funktionen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert DD_OK.

Wenn ein Fehler auftritt, gibt die Funktion DDERR_INVALIDPARAMSzurück.

Bemerkungen

Auf Computern mit mehreren Monitoren DirectDrawEnumerateEx mehrere Anzeigegeräte auflisten.

Sie müssen LoadLibrary- verwenden, um explizit mit Ddraw.dllzu verknüpfen. Rufen Sie zum Abrufen der Adresse der DirectDrawEnumerateEx--Funktion die GetProcAddress Win32-Funktion mit den Prozessnamenzeichenfolgen "DirectDrawEnumerateExA" (ANSI) oder "DirectDrawEnumerateExW" (Unicode) auf.

Hinweis

Der ddraw.h-Header definiert DirectDrawEnumerateEx als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Zielplattform- Fenster
Header- ddraw.h
Library Ddraw.lib
DLL- Ddraw.dll