DXGIDDICB_PRESENT_MULTIPLANE_OVERLAY-Struktur (dxgiddi.h)

Artikel
02/26/2024

Beschreibt mehrschichtige Überlagerungszuordnungen, in die Inhalte kopiert und aus denen kopiert wird.

Syntax

typedef struct DXGIDDICB_PRESENT_MULTIPLANE_OVERLAY {
  [in] void                                       *pDXGIContext;
  [in] HANDLE                                     hContext;
  [in] UINT                                       BroadcastContextCount;
       HANDLE                                     BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT];
  [in] DWORD                                      AllocationInfoCount;
       DXGIDDI_MULTIPLANE_OVERLAY_ALLOCATION_INFO AllocationInfo[DXGI_DDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS];
} DXGIDDICB_PRESENT_MULTIPLANE_OVERLAY;

Member

[in] pDXGIContext

Ein Handle für den DXGI-Kontext (Microsoft DirectX Graphics Infrastructure). Dieses Handle ist für den Treiber undurchsichtig. Der Treiber sollte diesem Member das Handle aus dem pDXGIContext-Member der DXGI_DDI_ARG_PRESENTMULTIPLANEOVERLAY-Struktur zuweisen, das der Treiber bei einem Aufruf seiner DXGI-Funktion (pfnPresentMultiplaneOverlay) empfangen hat.

[in] hContext

Ein Handle für den Kontext, an den der Treiber den Kopiervorgang übermittelt. Der Anzeigetreiber für den Benutzermodus hat diesen Kontext zuvor durch Aufrufen der PfnCreateContextCb-Funktion erstellt.

[in] BroadcastContextCount

Die Anzahl zusätzlicher Kontexte im Array, die vom BroadcastContext-Element angegeben wird.

[in] BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

Ein Array von Handles für die zusätzlichen Kontexte, an die der aktuelle aktuelle Vorgang übertragen werden soll. Die D3DDDI_MAX_BROADCAST_CONTEXT-Konstante , die als 64 definiert ist, definiert die maximale Anzahl zusätzlicher Kontexte, an die der Benutzermodusanzeigetreiber den aktuellen Vorgang übertragen kann.

Die Übertragung wird nur für Flip-Vorgänge unterstützt. Um einen Flip-Vorgang zu übertragen, muss der Anzeige-Miniporttreiber auf MMIO-Basis (Memory Mapped E/O) Flips unterstützen. Um die Unterstützung von MMIO-Flips anzugeben, legt der Anzeige-Miniporttreiber das FlipOnVSyncMmIo-Bitfeldflag im FlipCaps-Element der DXGK_DRIVERCAPS-Struktur fest, wenn die DxgkDdiQueryAdapterInfo-Funktion aufgerufen wird.

Der ursprüngliche Kontext, den der hContext-Member angibt und dem der Benutzermodusanzeigetreiber präsentiert, ist kein Element im BroadcastContext-Array . Wenn das BroadcastContext-Array beispielsweise ein Element enthält, sendet der Anzeigetreiber für den Benutzermodus den aktuellen Vorgang an den besitzenden Kontext (hContext) und sendet an diesen einen zusätzlichen Kontext.

[in] AllocationInfoCount

Die Anzahl der Zuordnungen im Array, die vom AllocationInfo-Element angegeben wird. Die maximale Zahl ist 16, der Wert der DXGI_DDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS Konstanten.

AllocationInfo[DXGI_DDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS]

Ein Array von Strukturen vom Typ DXGIDDI_MULTIPLANE_OVERLAY_ALLOCATION_INFO , die Informationen zu den Überlagerungszuordnungen mit mehreren Ebenen angeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1
Unterstützte Mindestversion (Server)	Windows Server 2012 R2
Kopfzeile	dxgiddi.h (include D3d10umddi.h)

Weitere Informationen

DXGIDDI_MULTIPLANE_OVERLAY_ALLOCATION_INFO

DXGI_DDI_ARG_PRESENTMULTIPLANEOVERLAY

DXGK_DRIVERCAPS

pfnCreateContextCb

pfnPresentMultiplaneOverlay (DXGI)

Freigeben über