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.
HRESULT DirectDrawEnumerateExW(
[in] LPDDENUMCALLBACKEXW lpCallback,
[in] LPVOID lpContext,
[in] DWORD dwFlags
);
[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.
Die Funktion listet das primäre Gerät und alle Anzeigegeräte auf, die an den Desktop angeschlossen sind.
Die Funktion listet das primäre Gerät und alle Anzeigegeräte auf, die nicht an den Desktop angeschlossen sind.
Die Funktion listet das primäre Gerät und alle Nichtanzeigegeräte auf, z. B. 3D-Zugriffstasten ohne 2D-Funktionen.
Wenn die Funktion erfolgreich ist, wird der Rückgabewert DD_OK.
Wenn ein Fehler auftritt, gibt die Funktion DDERR_INVALIDPARAMSzurück.
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.
Anforderung | Wert |
---|---|
Zielplattform- | Fenster |
Header- | ddraw.h |
Library | Ddraw.lib |
DLL- | Ddraw.dll |