EnumDisplayDevicesA-Funktion (winuser.h)

Artikel
08/27/2023

Mit der Funktion EnumDisplayDevices können Sie Informationen zu den Anzeigegeräten in der aktuellen Sitzung abrufen.

Syntax

BOOL EnumDisplayDevicesA(
  [in]  LPCSTR           lpDevice,
  [in]  DWORD            iDevNum,
  [out] PDISPLAY_DEVICEA lpDisplayDevice,
  [in]  DWORD            dwFlags
);

Parameter

[in] lpDevice

Ein Zeiger auf den Gerätenamen. Bei NULL gibt die Funktion basierend auf iDevNum Informationen für die Grafikkarten auf dem Computer zurück.

Weitere Informationen finden Sie in den Hinweisen.

[in] iDevNum

Ein Indexwert, der das interessante Anzeigegerät angibt.

Das Betriebssystem identifiziert jedes Anzeigegerät in der aktuellen Sitzung mit einem Indexwert. Bei den Indexwerten handelt es sich um aufeinanderfolgende ganze Zahlen, die bei 0 beginnen. Wenn die aktuelle Sitzung z. B. über drei Anzeigegeräte verfügt, werden diese durch die Indexwerte 0, 1 und 2 angegeben.

[out] lpDisplayDevice

Ein Zeiger auf eine DISPLAY_DEVICE Struktur, die Informationen über das von iDevNum angegebene Anzeigegerät empfängt.

Bevor Sie EnumDisplayDevices aufrufen, müssen Sie das cb-Element von DISPLAY_DEVICE auf die Größe (in Bytes) von DISPLAY_DEVICE initialisieren.

[in] dwFlags

Legen Sie dieses Flag auf EDD_GET_DEVICE_INTERFACE_NAME (0x00000001) fest, um den Geräteschnittstellennamen für GUID_DEVINTERFACE_MONITOR abzurufen, der vom Betriebssystem auf Monitorbasis registriert wird. Der Wert wird im DeviceID-Member der DISPLAY_DEVICE-Struktur platziert, die in lpDisplayDevice zurückgegeben wird. Der resultierende Geräteschnittstellenname kann mit SetupAPI-Funktionen verwendet werden und dient als Bindeglied zwischen GDI-Monitorgeräten und SetupAPI-Monitorgeräten.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Die Funktion schlägt fehl, wenn iDevNum größer als der größte Geräteindex ist.

Hinweise

Um alle Anzeigegeräte in der aktuellen Sitzung abzufragen, rufen Sie diese Funktion in einer Schleife auf, beginnend mit dem Festlegen von iDevNum auf 0, und erhöhen Sie iDevNum , bis die Funktion fehlschlägt. Um alle Anzeigegeräte auf dem Desktop auszuwählen, verwenden Sie nur die Anzeigegeräte, die das DISPLAY_DEVICE_ATTACHED_TO_DESKTOP-Flag in der DISPLAY_DEVICE Struktur aufweisen.

Rufen Sie EnumDisplayDevices auf, um Informationen zum Anzeigeadapter abzurufen, wobei lpDevice auf NULL festgelegt ist. Beispiel: DISPLAY_DEVICE. DeviceString enthält den Adapternamen.

Um Informationen zu einem Anzeigemonitor abzurufen, rufen Sie zuerst EnumDisplayDevices auf , wobei lpDevice auf NULL festgelegt ist. Rufen Sie dann EnumDisplayDevices auf , wobei lpDevice auf DISPLAY_DEVICE festgelegt ist. DeviceName ab dem ersten Aufruf von EnumDisplayDevices und mit festgelegtem iDevNum auf Null. Dann DISPLAY_DEVICE. DeviceString ist der Monitorname.

Um alle Monitorgeräte abzufragen, die einem Adapter zugeordnet sind, rufen Sie EnumDisplayDevices in einer Schleife auf, wobei lpDevice auf den Adapternamen festgelegt ist, iDevNum auf start bei 0 und iDevNum auf Inkrement festgelegt ist, bis die Funktion fehlschlägt. Beachten Sie, dass DISPLAY_DEVICE. DeviceName ändert sich mit jedem Aufruf für Monitorinformationen. Daher müssen Sie den Adapternamen speichern. Die Funktion schlägt fehl, wenn keine Monitore mehr für den Adapter vorhanden sind.

Hinweis

Der winuser.h-Header definiert EnumDisplayDevices 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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-sysparams-ext-l1-1-1 (eingeführt in Windows 10, Version 10.0.14393)