DXGK_SETVIDPNSOURCEADDRESS_FLAGS Struktur (d3dkmddi.h)

Artikel
02/06/2025

Die DXGK_SETVIDPNSOURCEADDRESS_FLAGS-Struktur identifiziert den spezifischen Vorgangstyp, der in einem Aufruf der dxgkDdiSetVidPnSourceAddress oder DxgkDdiSetVidPnSourceAddressWithMultiPlaneOverlay- Funktionen 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;

Angehörige

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-Value Members (0x00000001).

FlipImmediate

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

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

FlipOnNextVSync

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

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

[in] FlipStereo

Wird ab Windows 8 unterstützt.

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

Wenn das FlipOnNextVSync- Mitglied der DXGK_SETVIDPNSOURCEADDRESS_FLAGS-Struktur festgelegt ist, schließt der Treiber das Kippen auf das linke Bild auf dem nächsten VSync ab und schließt dann das Flip to the right image on the following VSync ab.

Wenn das FlipImmediate- Mitglied der DXGK_SETVIDPNSOURCEADDRESS_FLAGS-Struktur festgelegt ist, beginnt der Treiber sofort mit dem Scan aus der neuen Zuordnung. Wenn der Treiber z. B. ein richtiges Bild scannt, wird der neue Scan vom gleichen relativen Offset im rechten Bild der neuen Zuordnung gestartet.

Die FlipStereo und FlipStereoTemporaryMono Mitglieder 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-Value Members (0x00000008).

[in] FlipStereoTemporaryMono

Wird ab Windows 8 unterstützt.

Gibt an, ob der Treiber das linke Bild einer Stereozuordnung für die rechten und linken Teile eines Stereoframes verwendet. Der Treiber führt den gleichen aktuellen Vorgang wie bei FlipStereoaus, außer dass er nur aus dem linken Bild scannt, um beide Bilder eines Stereoframes zu erzeugen.

Dieses Element sollte nur festgelegt werden, wenn der Treiber die Unterstützung für diese Option im aktuellen Anzeigemodus meldet, indem der Typ Member der D3DKMDT_VIDPN_SOURCE_MODE-Struktur auf D3DKMDT_RMT_GRAPHICS_STEREO_ADVANCED_SCAN festgelegt wird.

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

Die FlipStereoTemporaryMono und FlipStereoPreferRight Mitglieder 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-Value Members (0x00000010).

[in] FlipStereoPreferRight

Wird ab Windows 8 unterstützt.

Gibt an, dass beim Klonen des Treibers eine primäre Stereozuordnung für einen Monomonitor das richtige Bild verwendet wird.

Die FlipStereoTemporaryMono und FlipStereoPreferRight Mitglieder 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-Value Members (0x00000020).

[in] SharedPrimaryTransition

Wird ab Windows 8 unterstützt.

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

Dieses Element wird festgelegt, wenn einer der folgenden Übergänge auftritt:

Die aktuelle primäre Zuordnung ist keine gemeinsame primäre Zuordnung, sondern die neue.
Die aktuelle primäre Zuordnung ist eine gemeinsame primäre Zuordnung, aber die neue zuordnung ist nicht.

Wenn SharedPrimaryTransition- festgelegt ist, muss der Miniporttreiber überprüfen, ob die Hardware nahtlos zwischen primären und freigegebenen primären Zuordnungen wechseln kann, und sie muss jede Hardwareprogrammierung durchführen, die erforderlich ist, um den nahtlosen Umstieg zu ermöglichen.

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

[in] IndependentFlipExclusive

Wird ab Windows 10 unterstützt.

Wenn IndependentFlipExlusive festgelegt ist, erfolgt das Kippen im unabhängigen Flip-Exklusivmodus. Auf den Frontpuffer wird nur über die Anzeigehardware (nicht durch dwM) zugegriffen, und der Kernelmodustreiber kann vertikale Synchronisierungsoptimierungen anwenden.

[in] MoveFlip

Wird ab Windows 10 unterstützt.

Wenn MoveFlip- festgelegt ist, wird der Treiber benachrichtigt, einen Beliebigen Zustand zu verwenden, der aus dem vorherigen Flip gespeichert wurde, um die neue Scanoutanforderung zu konfigurieren.

[in] Reserved

Dieses Element ist reserviert und sollte auf Null festgelegt werden. Das Festlegen dieses Elements auf Null entspricht dem Festlegen der verbleibenden 23 Bits (0xFFFFFF00) des 32-Bit-Werts Members auf Nullen.

Value

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

Bemerkungen

Wenn eines der FlipStereo, FlipStereoTemporaryMonooder FlipStereoPreferRight Mitglieder festgelegt sind, gelten die folgenden Bedingungen:

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

Ab Windows 8 kann der Anzeigeminiporttreiber einen Aufruf der DxgkDdiSetVidPnSourceAddress-Funktion nicht ausführen und STATUS_INVALID_PARAMETER zurückgeben, wenn der SharedPrimaryTransition- Member in pSetVidPnSourceAddress->Flagsfestgelegt ist. Ein solcher Fehler wird jedoch nicht erwartet, 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, schlägt das Betriebssystem nicht nahtlos in den Kompositionsmodus zurück, und die Präsentation ist falsch.