DXGK_SETVIDPNSOURCEADDRESS_FLAGS-Struktur (d3dkmddi.h)

Artikel
02/23/2024

Die DXGK_SETVIDPNSOURCEADDRESS_FLAGS-Struktur gibt den spezifischen Vorgangstyp an, der in einem Aufruf der Funktionen DxgkDdiSetVidPnSourceAddress oder DxgkDdiSetVidPnSourceAddressWithMultiPlaneOverlay des Anzeigeminiporttreibers ausgeführt werden soll.

Syntax

typedef struct _DXGK_SETVIDPNSOURCEADDRESS_FLAGS {
  union {
    struct {
      UINT ModeChange : 1;
      UINT FlipImmediate : 1;
      UINT FlipOnNextVSync : 1;
      UINT FlipStereo : 1;
      UINT FlipStereoTemporaryMono : 1;
      UINT FlipStereoPreferRight : 1;
      UINT SharedPrimaryTransition : 1;
      UINT IndependentFlipExclusive : 1;
      UINT MoveFlip : 1;
#if ...
      UINT Reserved : 23;
#elif
      UINT Reserved : 24;
#elif
      UINT Reserved : 25;
#else
      UINT Reserved : 29;
#endif
    };
         UINT Value;
  };
} DXGK_SETVIDPNSOURCEADDRESS_FLAGS;

Member

ModeChange

Ein UINT-Wert, der angibt, dass der Treiber den Anzeigemodus wechselt.

Das Festlegen dieses Elements entspricht dem Festlegen des ersten Bits des 32-Bit-Elements Wert (0x00000001).

FlipImmediate

Ein UINT-Wert, der angibt, dass der Treiber einen Flip-Vorgang ohne vertikale Synchronisierung ausführt.

Das Festlegen dieses Elements entspricht dem Festlegen des zweiten Bits des 32-Bit-Wertmembers (0x00000002).

FlipOnNextVSync

Ein UINT-Wert, der angibt, dass der Treiber einen Flip-Vorgang ausführt, der bei der nächsten vertikalen Synchronisierung auftritt.

Das Festlegen dieses Elements entspricht dem Festlegen des dritten Bits des 32-Bit-Elements Wert (0x00000004).

[in] FlipStereo

Unterstützt ab Windows 8.

Gibt an, ob der Treiber sowohl linke als auch rechte Bilder einer Stereozuordnung umdreht.

Wenn das FlipOnNextVSync-Element der DXGK_SETVIDPNSOURCEADDRESS_FLAGS-Struktur festgelegt ist, schließt der Treiber auf der nächsten VSync das Blättern nach links ab und schließt dann den Blättern zum rechten Bild auf der folgenden VSync ab.

Wenn das FlipImmediate-Element der DXGK_SETVIDPNSOURCEADDRESS_FLAGS-Struktur festgelegt ist, beginnt der Treiber sofort mit dem Scannen aus der neuen Zuordnung. Wenn der Treiber beispielsweise ein rechtes Bild überprüft hat, startet er die neue Überprüfung mit demselben relativen Offset im rechten Bild der neuen Zuordnung.

Die Member FlipStereo und FlipStereoTemporaryMono können nicht gleichzeitig festgelegt werden.

Weitere Anforderungen finden Sie im Abschnitt Hinweise.

Das Festlegen dieses Elements entspricht dem Festlegen des vierten Bits des 32-Bit-Wertmembers (0x00000008).

[in] FlipStereoTemporaryMono

Unterstützt ab Windows 8.

Gibt an, ob der Treiber das linke Bild einer Stereozuordnung für den rechten und linken Teil eines Stereoframes verwendet. Der Treiber führt den gleichen aktuellen Vorgang wie bei FlipStereo aus, mit der Ausnahme, dass er nur vom linken Bild aus scannt, um beide Bilder eines Stereoframes zu erzeugen.

Dieser Member sollte nur festgelegt werden, wenn der Treiber unterstützung für diese Option im aktuellen Anzeigemodus meldet, indem er den Typmember der D3DKMDT_VIDPN_SOURCE_MODE-Struktur auf D3DKMDT_RMT_GRAPHICS_STEREO_ADVANCED_SCAN festlegt.

Die Member FlipStereo und FlipStereoTemporaryMono können nicht gleichzeitig festgelegt werden.

Die Member FlipStereoTemporaryMono und FlipStereoPreferRight können nicht gleichzeitig festgelegt werden.

Weitere Anforderungen finden Sie im Abschnitt Hinweise.

Das Festlegen dieses Elements entspricht dem Festlegen des fünften Bits des 32-Bit-Elements Wert (0x00000010).

[in] FlipStereoPreferRight

Unterstützt ab Windows 8.

Gibt an, dass der Treiber beim Klonen einer primären Stereozuordnung zu einem Monomonitor das richtige Bild verwendet.

Die Member FlipStereoTemporaryMono und FlipStereoPreferRight können nicht gleichzeitig festgelegt werden.

Weitere Anforderungen finden Sie im Abschnitt Hinweise.

Das Festlegen dieses Elements entspricht dem Festlegen des sechsten Bits des 32-Bit-Wertelements (0x00000020).

[in] SharedPrimaryTransition

Unterstützt ab Windows 8.

Gibt an, dass der Treiber zu oder von einer freigegebenen verwalteten primären Zuordnung wechselt.

Dieser Member wird festgelegt, wenn einer der folgenden Übergänge auftritt:

Bei der aktuellen primären Zuordnung handelt es sich nicht um eine freigegebene primäre Zuordnung, sondern um die neue.
Die aktuelle primäre Zuordnung ist eine freigegebene primäre Zuordnung, die neue jedoch nicht.

Wenn SharedPrimaryTransition festgelegt ist, muss der Anzeige-Miniporttreiber überprüfen, ob die Hardware nahtlos zwischen primären und freigegebenen primären Zuordnungen hin- und herwechseln kann, und er muss jede Hardwareprogrammierung durchführen, die für den nahtlosen Wechsel erforderlich ist.

Das Festlegen dieses Elements entspricht dem Festlegen des siebten Bits des 32-Bit-Elements Wert (0x00000040).

[in] IndependentFlipExclusive

Unterstützt ab Windows 10.

Wenn IndependentFlipExlusive festgelegt ist, erfolgt das Flipen im unabhängigen exklusiven Flip-Modus. Auf den Frontpuffer kann nur über die Anzeigehardware (nicht durch dwm) zugegriffen werden, und der Kernelmodustreiber kann vertikale Synchronisierungsoptimierungen anwenden.

[in] MoveFlip

Unterstützt ab Windows 10.

Wenn MoveFlip festgelegt ist, wird der Treiber benachrichtigt, einen beliebigen Zustand zu verwenden, der vor dem vorherigen Flip gespeichert wurde, um die neue Scanout-Anforderung zu konfigurieren.

[in] Reserved

Dieser Member ist reserviert und sollte auf 0 (null) festgelegt werden. Das Festlegen dieses Elements auf 0 (null) entspricht dem Festlegen der verbleibenden 23 Bits (0xFFFFFF00) des 32-Bit-Wertmembers auf Nullen.

Value

Ein Element in der Union, das DXGK_SETVIDPNSOURCEADDRESS_FLAGS enthält, das einen 32-Bit-Wert enthalten kann, der den Vorgangstyp identifiziert.

Hinweise

Wenn eines der Member FlipStereo, FlipStereoTemporaryMono oder FlipStereoPreferRight festgelegt ist, gelten diese Bedingungen:

Das hAllocation-Element der DXGKARG_SETVIDPNSOURCEADDRESS-Struktur verweist auf eine Zuordnung, die mit dem stereo-Element erstellt wird, das im Flags-Element der D3DKMT_DISPLAYMODE-Struktur festgelegt ist.
Die Member PrimarySegment und PrimaryAddress von DXGKARG_SETVIDPNSOURCEADDRESS auf die physische Startadresse der Zuordnung verweisen.
Der Treiber berücksichtigt die Einstellungen der FlipImmediate - und FlipOnNextVSync-Member der DXGK_SETVIDPNSOURCEADDRESS_FLAGS-Struktur .

Ab Windows 8 kann der Anzeige-Miniporttreiber einen Aufruf der DxgkDdiSetVidPnSourceAddress-Funktion fehlschlagen und STATUS_INVALID_PARAMETER zurückgeben, wenn das SharedPrimaryTransition-Element in pSetVidPnSourceAddress-Flags-> festgelegt ist. Ein solcher Fehler ist jedoch nicht zu erwarten, es sei denn, es liegt ein Fehler in der Implementierung des Benutzermodustreibers der CheckDirectFlipSupport-Funktion oder im Desktopfenster-Manager (DWM) vor. Wenn ein solcher Fehler auftritt, führt das Betriebssystem kein nahtloses Failback in den Kompositionsmodus durch, und die Darstellung ist falsch.