DXGIDDICB_PRESENT_MULTIPLANE_OVERLAY-Struktur (dxgiddi.h)

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

Weitere Informationen

DXGIDDI_MULTIPLANE_OVERLAY_ALLOCATION_INFO

DXGI_DDI_ARG_PRESENTMULTIPLANEOVERLAY

DXGK_DRIVERCAPS

pfnCreateContextCb

pfnPresentMultiplaneOverlay (DXGI)