D3DDDICB_PRESENTMULTIPLANEOVERLAY Struktur (d3dumddi.h)

Artikel
02/06/2025

Beschreibt mehrplanige Überlagerungszuordnungen, in die Inhalte kopiert werden.

Syntax

typedef struct D3DDDICB_PRESENTMULTIPLANEOVERLAY {
  [in] HANDLE                            hContext;
  [in] UINT                              BroadcastContextCount;
       HANDLE                            BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT];
  [in] UINT                              AllocationInfoCount;
       D3DDDI_MULTIPLANE_ALLOCATION_INFO AllocationInfo[D3DDDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS];
} D3DDDICB_PRESENTMULTIPLANEOVERLAY;

Angehörige

[in] hContext

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

[in] BroadcastContextCount

Die Anzahl der zusätzlichen Kontexte im Array, die vom BroadcastContext Member angegeben werden.

[in] BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

Ein Array von Handles für die zusätzlichen Kontexte, um den aktuellen aktuellen Vorgang zu übertragen. Die D3DDDI_MAX_BROADCAST_CONTEXT Konstante, die als 64 definiert ist, definiert die maximale Anzahl zusätzlicher Kontexte, an die der Anzeigetreiber für den Benutzermodus den aktuellen aktuellen Vorgang übertragen kann.

Die Übertragung wird nur für Flip-Vorgänge unterstützt. Um einen Flip-Vorgang zu übertragen, muss der Miniporttreiber speicherbasierte I/O (MMIO)-basierte Flips unterstützen. Um die Unterstützung von MMIO-Flips anzugeben, legt der Miniporttreiber die FlipOnVSyncMmIo Bitfeldflagge im FlipCaps-element der DXGK_DRIVERCAPS-Struktur fest, wenn die DxgkDdiQueryAdapterInfo-Funktion aufgerufen wird.

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

[in] AllocationInfoCount

Die Anzahl der Zuordnungen im Array, die vom AllocationInfo Member angegeben werden. Die maximale Zahl ist 16, der Wert der D3DDDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS Konstanten.

AllocationInfo[D3DDDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS]

Ein Array von Strukturen vom Typ D3DDDI_MULTIPLANE_ALLOCATION_INFO, die Informationen zu den Mehrplanüberlagerungszuordnungen angeben.