DISPLAYCONFIG_PATH_SOURCE_INFO Struktur (wingdi.h)

Artikel
03/04/2024

Die DISPLAYCONFIG_PATH_SOURCE_INFO-Struktur enthält Quellinformationen für einen einzelnen Pfad.

Syntax

typedef struct DISPLAYCONFIG_PATH_SOURCE_INFO {
  LUID   adapterId;
  UINT32 id;
  union {
    UINT32 modeInfoIdx;
    struct {
      UINT32 cloneGroupId : 16;
      UINT32 sourceModeInfoIdx : 16;
    } DUMMYSTRUCTNAME;
  } DUMMYUNIONNAME;
  UINT32 statusFlags;
} DISPLAYCONFIG_PATH_SOURCE_INFO;

Member

adapterId

Der Bezeichner des Adapters, auf den sich diese Quellinformationen beziehen.

id

Der Quellbezeichner auf dem angegebenen Adapter, auf den sich dieser Pfad bezieht.

DUMMYUNIONNAME

DUMMYUNIONNAME.modeInfoIdx

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

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.cloneGroupId

Ein gültiger Bezeichner, mit dem nur angezeigt wird, in welcher Klongruppe der Pfad Mitglied ist, wenn DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE festgelegt ist. Wenn dieser Wert ungültig ist, muss er auf DISPLAYCONFIG_PATH_CLONE_GROUP_INVALID festgelegt werden.

cloneGroupId wird nur verwendet, wenn der Quellmodusindex nicht angegeben ist. Zwei solche Szenarien sind, wenn die Quellmodusinformationen ungültig sein müssen, weil SDC_TOPOLOGY_SUPPLIED verwendet wird, und wenn SDC_USE_SUPPLIED_DISPLAY_CONFIG mit Pfaden verwendet wird, die keine Quellmodusinformationen enthalten. Die cloneGroupId wird verwendet, um anzugeben, welche Pfade sich in einer Klongruppe befinden. Alle Pfade mit demselben cloneGroupId-Wert werden in derselben Klongruppe berücksichtigt. Es ist nicht erforderlich, dass die Klongruppen-IDs nullbasiert oder zusammenhängend sein müssen. Unterstützt ab Windows 10.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.sourceModeInfoIdx

Ein gültiger Index im Modusarray des DISPLAYCONFIG_SOURCE_MODE Eintrags, der die Quellmodusinformationen 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 sourceModeInfoIdx DISPLAYCONFIG_PATH_SOURCE_MODE_IDX_INVALID. Unterstützt ab Windows 10.

statusFlags

Ein bitweises OR mit Flagwerten, das die status der Quelle angibt. Die folgenden Werte werden unterstützt:

DISPLAYCONFIG_SOURCE_IN_USE

Diese Quelle wird von mindestens einem aktiven Pfad verwendet.

Hinweise

Eine DISPLAYCONFIG_PATH_SOURCE_INFO-Struktur wird im sourceInfo-Member einer DISPLAYCONFIG_PATH_INFO-Struktur angegeben.

Eine Quelle entspricht einer Oberfläche, auf der die Grafikkarte Pixel rendern kann. Jeder Grafikkarte kann in x Anzahl von Quellen gerendert werden. Dies bedeutet, wie viele Desktops für den Erweiterungsmodus gerendert werden können. Dies ist in der Regel 2. Beispielsweise kann Quelle 0 Pixel von 0,0 bis 1024.768 rendern, und Quelle 1 kann Pixel von 1025,0 bis 2048, 768 rendern.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar im Windows 7-Client.
Kopfzeile	wingdi.h (windows.h einschließen)

Weitere Informationen

DISPLAYCONFIG_PATH_INFO

Share via