DISPLAY_DEVICEW Struktur (wingdi.h)
Die DISPLAY_DEVICE Struktur empfängt Informationen über das anzeigegerät, das vom 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;
Angehörige
cb
Größe der DISPLAY_DEVICE Struktur in Byte. Dies muss vor dem Aufrufen EnumDisplayDevicesinitialisiert 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, die die Gerätekontextzeichenfolge enthalten. Dies ist entweder eine Beschreibung des Anzeigeadapters oder des Anzeigemonitors.
StateFlags
Gerätestatuskennzeichnungen. Es 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 "aktiviert" dargestellt wird. Windows Vista: EnumDisplayDevices werden nur Monitore aufzählen, die als "ein" dargestellt werden können. |
DISPLAY_DEVICE_MIRRORING_DRIVER | Stellt ein Pseudogerät dar, das zum Spiegeln der Anwendungszeichnung für Remoting oder andere Zwecke verwendet wird. Diesem Gerät ist ein unsichtbarer Pseudomonitor zugeordnet. Beispiel: NetMeeting verwendet es. Beachten Sie, dass GetSystemMetrics- (SM_MONITORS) nur sichtbare Anzeigemonitore enthält. |
DISPLAY_DEVICE_MODESPRUNED | Das Gerät verfügt über mehr Anzeigemodi als die Ausgabegeräte. |
DISPLAY_DEVICE_PRIMARY_DEVICE | Der primäre Desktop befindet sich auf dem Gerät. Für ein System mit einer einzelnen Anzeigekarte wird dies immer festgelegt. Für ein System mit mehreren Anzeigekarten kann nur ein Gerät diesen Satz aufweisen. |
DISPLAY_DEVICE_REMOVABLE | Das Gerät ist wechselbar; 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.
Bemerkungen
Die vier Zeichenfolgenelemente werden basierend auf den Parametern festgelegt, die an EnumDisplayDevicesübergeben werden. Wenn der lpDevice Param NULL-ist, wird DISPLAY_DEVICE mit Informationen über die 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.
Anmerkung
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
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
Header- | wingdi.h (enthalten Windows.h) |
Siehe auch
übersicht über Gerätekontexte