Share via


DISPLAY_DEVICEW Struktur (wingdi.h)

Die DISPLAY_DEVICE-Struktur empfängt Informationen über das Anzeigegerät, das durch den iDevNum-Parameter der EnumDisplayDevices-Funktion angegeben wird.

Syntax

typedef struct _DISPLAY_DEVICEW {
  DWORD cb;
  WCHAR DeviceName[32];
  WCHAR DeviceString[128];
  DWORD StateFlags;
  WCHAR DeviceID[128];
  WCHAR DeviceKey[128];
} DISPLAY_DEVICEW, *PDISPLAY_DEVICEW, *LPDISPLAY_DEVICEW;

Member

cb

Größe der DISPLAY_DEVICE-Struktur in Byte. Dies muss vor dem Aufruf von EnumDisplayDevices initialisiert werden.

DeviceName[32]

Ein Array von Zeichen, die den Gerätenamen identifizieren. Dies ist entweder das Adaptergerät oder das Monitorgerät.

DeviceString[128]

Ein Array von Zeichen, das die Gerätekontextzeichenfolge enthält. Dies ist entweder eine Beschreibung der Grafikkarte oder des Anzeigemonitors.

StateFlags

Gerätestatusflags. Dies kann eine beliebige vernünftige Kombination der folgenden Sein.

Wert Bedeutung
DISPLAY_DEVICE_ACTIVE DISPLAY_DEVICE_ACTIVE gibt an, ob ein Monitor von der jeweiligen GDI-Ansicht als "on" dargestellt wird. Windows Vista: EnumDisplayDevices listet nur Monitore auf, die als "aktiviert" dargestellt werden können.
DISPLAY_DEVICE_MIRRORING_DRIVER Stellt ein Pseudogerät dar, das zum Spiegel der Anwendungszeichnung für Remoting- oder andere Zwecke verwendet wird. Diesem Gerät ist ein unsichtbarer Pseudomonitor zugeordnet. NetMeeting verwendet sie beispielsweise. Beachten Sie, dass GetSystemMetrics (SM_MONITORS) nur sichtbare Anzeigemonitore erfasst.
DISPLAY_DEVICE_MODESPRUNED Das Gerät verfügt über mehr Anzeigemodi, als seine Ausgabegeräte unterstützen.
DISPLAY_DEVICE_PRIMARY_DEVICE Der primäre Desktop befindet sich auf dem Gerät. Für ein System mit einer einzelnen Anzeige Karte ist dies immer festgelegt. Bei einem System mit mehreren Anzeigekarten kann dieser Satz nur auf einem Gerät festgelegt werden.
DISPLAY_DEVICE_REMOVABLE Das Gerät ist entfernbar. es kann nicht die primäre Anzeige sein.
DISPLAY_DEVICE_VGA_COMPATIBLE Das Gerät ist VGA-kompatibel.

DeviceID[128]

Wird nicht verwendet.

DeviceKey[128]

Reserviert.

Hinweise

Die vier Zeichenfolgenmember werden basierend auf den Parametern festgelegt, die an EnumDisplayDevices übergeben werden. Wenn der lpDevice-ParamNULL ist, wird DISPLAY_DEVICE mit Informationen zu den Grafikkarten ausgefüllt. Wenn es sich um einen gültigen Gerätenamen handelt, wird er mit Informationen zu den Monitoren für dieses Gerät ausgefüllt.

Hinweis

Der wingdi.h-Header definiert DISPLAY_DEVICE als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile wingdi.h (windows.h einschließen)

Weitere Informationen

Gerätekontextstrukturen

Übersicht über Gerätekontexte

EnumDisplayDevices

GetSystemMetrics