DXGI_DDI_PRIMARY_DESC-Struktur (dxgiddi.h)

Beschreibt eine Ressource, die als primäre Ressource verwendet wird (d. a. eine Ressource, die auf der Anzeige gescannt wird).

Syntax

typedef struct DXGI_DDI_PRIMARY_DESC {
  [in]  UINT                           Flags;
  [in]  D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  [in]  DXGI_DDI_MODE_DESC             ModeDesc;
  [out] UINT                           DriverFlags;
} DXGI_DDI_PRIMARY_DESC;

Member

[in] Flags

Ein gültiges bitweises OR mit einem der folgenden Werte, der angibt, wie die Ressource angezeigt wird.

Wert	Bedeutung
DXGI_DDI_PRIMARY_OPTIONAL (0x1)	Der Anzeigetreiber für den Benutzermodus kann verhindern, dass die Ressource jemals eine primäre Ressource ist. Der Treiber kann das tatsächliche Flipen (von optionaler primärer zu regulärer primärer Instanz) verhindern und einen Kopiervorgang im Format "Present" verwenden. Daher kann der Treiber auf diese Weise verhindern, dass die Ressource tatsächlich als primäre Ressource verwendet wird.
DXGI_DDI_PRIMARY_NONPREROTATED (0x2)	Das primäre Objekt stellt tatsächlich die DXGI_DDI_MODE_ROTATION_IDENTITY-Typ-Drehung dar, obwohl sie in Anzeigemodi ohne DXGI_DDI_MODE_ROTATION_IDENTITY verwendet wird, da Anwendungen die Ausgabeausrichtung verarbeiten, indem sie z. B. den Viewport und die Projektionsmatrix drehen.
DXGI_DDI_PRIMARY_STEREO (0x4)	Unterstützt in Windows 8 und höheren Versionen. Das primäre Element stellt einen Stereobackpuffer dar.
DXGI_DDI_PRIMARY_INDIRECT (0x8)	Unterstützt in Windows 10 und höheren Versionen. Das primäre Gerät wird für die Präsentation auf einem indirekten Anzeigegerät verwendet.

[in] VidPnSourceId

Die nullbasierte Identifikationsnummer der vorhandenen Videoquelle in einem Pfad einer VidPN-Topologie (Video Present Network), auf der die primäre Oberfläche erstellt wird.

[in] ModeDesc

Eine DXGI_DDI_MODE_DESC-Struktur , die den Anzeigemodus beschreibt.

[out] DriverFlags

Ein gültiges bitweises OR mit Werten, die angeben, wie der Treiber die Ressource anzeigen kann.

Der DXGI_DDI_PRIMARY_DRIVER_FLAG_NO_SCANOUT -Wert (0x1) ist derzeit der einzige unterstützte Wert. Dieses Bit gibt an, dass der Treiber die Laufzeiteinstellung für unterresource der angegebenen Ressource als primäre Ressource nicht unterstützen kann. Der Anzeigetreiber für den Benutzermodus sollte dieses Bit festlegen, wenn die Präsentation von dieser Oberfläche über einen Kopiervorgang implementiert wird. Daher verwendet die Runtime keine Flip-Präsentation, wenn dieses Bit festgelegt ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile	dxgiddi.h (include D3d10umddi.h)

Weitere Informationen

D3D10DDIARG_CREATERESOURCE

DXGI_DDI_MODE_DESC