DISPLAYCONFIG_PATH_TARGET_INFO Struktur (wingdi.h)

Artikel
03/09/2024

Die DISPLAYCONFIG_PATH_TARGET_INFO-Struktur enthält Zielinformationen für einen einzelnen Pfad.

Syntax

typedef struct DISPLAYCONFIG_PATH_TARGET_INFO {
  LUID                                  adapterId;
  UINT32                                id;
  union {
    UINT32 modeInfoIdx;
    struct {
      UINT32 desktopModeInfoIdx : 16;
      UINT32 targetModeInfoIdx : 16;
    } DUMMYSTRUCTNAME;
  } DUMMYUNIONNAME;
  DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY outputTechnology;
  DISPLAYCONFIG_ROTATION                rotation;
  DISPLAYCONFIG_SCALING                 scaling;
  DISPLAYCONFIG_RATIONAL                refreshRate;
  DISPLAYCONFIG_SCANLINE_ORDERING       scanLineOrdering;
  BOOL                                  targetAvailable;
  UINT32                                statusFlags;
} DISPLAYCONFIG_PATH_TARGET_INFO;

Member

adapterId

Der Bezeichner des Adapters, auf dem sich der Pfad befindet.

id

Der Zielbezeichner für den angegebenen Adapter, auf den sich dieser Pfad bezieht.

DUMMYUNIONNAME

DUMMYUNIONNAME.modeInfoIdx

Ein gültiger Index in der Modusinformationstabelle, der die Zielmodusinformationen für diesen Pfad nur enthält, wenn DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE nicht festgelegt ist. Wenn keine Zielmodusinformationen verfügbar sind, wird der Wert von modeInfoIdx DISPLAYCONFIG_PATH_MODE_IDX_INVALID.

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.desktopModeInfoIdx

Ein gültiger Index in das Modusarray des DISPLAYCONFIG_DESKTOP_IMAGE_INFO Eintrags, der die Desktopmodusinformationen für diesen Pfad nur enthält, wenn DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE festgelegt ist. Wenn im Modusarray kein Eintrag dafür vorhanden ist, wird der Wert von desktopModeInfoIdx DISPLAYCONFIG_PATH_DESKTOP_IMAGE_IDX_INVALID. Wird ab Windows 10 unterstützt.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.targetModeInfoIdx

Ein gültiger Index in das Modusarray des DISPLAYCONFIG_TARGET_MODE Eintrags, der die Zielmodusinformationen für diesen Pfad nur enthält, wenn DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE festgelegt ist. Wenn im Modusarray kein Eintrag dafür vorhanden ist, wird der Wert von targetModeInfoIdx DISPLAYCONFIG_PATH_TARGET_MODE_IDX_INVALID. Wird ab Windows 10 unterstützt.

outputTechnology

Der Connectortyp des Ziels. Eine Liste der möglichen Werte finden Sie im DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY aufgezählten Typs.

rotation

Ein Wert, der die Rotation des Ziels angibt. Eine Liste der möglichen Werte finden Sie im DISPLAYCONFIG_ROTATION aufgezählten Typ.

scaling

Ein Wert, der angibt, wie das Quellimage auf das Ziel skaliert wird. Eine Liste der möglichen Werte finden Sie im DISPLAYCONFIG_SCALING aufgezählten Typs. Weitere Informationen zur Skalierung finden Sie unter Skalieren des Desktopimages.

refreshRate

Eine DISPLAYCONFIG_RATIONAL-Struktur , die die Aktualisierungsrate des Ziels angibt. Wenn der Aufrufer Zielmodusinformationen angibt, verwendet das Betriebssystem stattdessen die Aktualisierungsrate, die im vSyncFreq-Member der DISPLAYCONFIG_VIDEO_SIGNAL_INFO-Struktur gespeichert ist. In diesem Fall gibt der Aufrufer diesen Wert im TargetVideoSignalInfo-Member der DISPLAYCONFIG_TARGET_MODE-Struktur an. Eine Aktualisierungsrate, bei der sowohl der Zähler als auch der Nenner auf 0 festgelegt ist, gibt an, dass der Aufrufer keine Aktualisierungsrate angibt und das Betriebssystem die optimale verfügbare Aktualisierungsrate verwenden sollte. In diesem Fall muss der Aufrufer bei einem Aufruf der SetDisplayConfig-Funktion den scanLineOrdering-Member auf den DISPLAYCONFIG_SCANLINE_ORDERING_UNSPECIFIED-Wert festlegen. Andernfalls schlägt SetDisplayConfig fehl.

scanLineOrdering

Ein Wert, der die Reihenfolge der Scanzeile der Ausgabe auf dem Ziel angibt. Eine Liste der möglichen Werte finden Sie im DISPLAYCONFIG_SCANLINE_ORDERING aufgezählten Typs. Wenn der Aufrufer Zielmodusinformationen angibt, verwendet das Betriebssystem stattdessen die Scanzeilenreihenfolge, die im scanLineOrdering-Member der DISPLAYCONFIG_VIDEO_SIGNAL_INFO-Struktur gespeichert ist. In diesem Fall gibt der Aufrufer diesen Wert im TargetVideoSignalInfo-Member der DISPLAYCONFIG_TARGET_MODE-Struktur an.

targetAvailable

Ein boolescher Wert, der angibt, ob das Ziel verfügbar ist. TRUE gibt an, dass das Ziel verfügbar ist.

Da sich die asynchrone Natur der Anzeigetopologie ändert, wenn ein Monitor entfernt wird, kann ein Pfad trotzdem als aktiv markiert werden, auch wenn der Monitor entfernt wurde. In einem solchen Fall kann targetAvailable für einen aktiven Pfad FALSE sein. Dies ist in der Regel eine vorübergehende Situation, die sich ändert, nachdem das Betriebssystem Maßnahmen zum Entfernen des Monitors ergriffen hat.

statusFlags

Ein bitweiser OR mit Flagwerten, der die status des Ziels angibt. Die folgenden Werte werden unterstützt:

Wert	Bedeutung
DISPLAYCONFIG_TARGET_IN_USE 0x00000001	Das Ziel wird in einem aktiven Pfad verwendet.
DISPLAYCONFIG_TARGET_FORCIBLE 0x00000002	Die Ausgabe kann für dieses Ziel erzwungen werden, auch wenn ein Monitor nicht erkannt wird.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_BOOT 0x00000004	Die Ausgabe wird derzeit auf bootbeständige Weise erzwungen.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_PATH 0x00000008	Die Ausgabe wird derzeit pfadbeharrend erzwungen.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_SYSTEM 0x00000010	Die Ausgabe wird derzeit nicht erzwungen.
DISPLAYCONFIG_TARGET_IS_HMD 0x00000020	Die Ausgabe ist ein Head-Mounted Display (HMD). Ein solcher Pfad wird nur von QueryDisplayConfig mit dem flag QDC_INCLUDE_HMD zurückgegeben. Wird ab Windows 10 Creators Update (Version 1703) unterstützt.

Hinweise

Eine DISPLAYCONFIG_PATH_TARGET_INFO-Struktur wird im targetInfo-Member einer DISPLAYCONFIG_PATH_INFO-Struktur angegeben.

Ein Ziel entspricht der Anzahl möglicher Videoausgaben auf einer Grafikkarte. Diese Zahl entspricht jedoch nicht der Anzahl der physischen Connectors auf dem Displayadapter. Jeder Connector macht eine Reihe von Zielen verfügbar, die Abwärtskompatibilität mit älteren Connectortechnologien enthalten. Ein DVI-Connector macht beispielsweise ein DVI-Ziel sowie ein VGA-Ziel verfügbar. Ein DisplayPort-Anschluss, der 2006 eingeführt wurde, macht DisplayPort-, HDMI-, DVI-, Legacy-TV- und VGA-Ziele verfügbar.

Der statusFlags-Member wird festgelegt, wenn Sie die QueryDisplayConfig-Funktion aufrufen.