DXGIDDICB_PRESENT-Struktur (dxgiddi.h)

Artikel
02/26/2024

Die DXGIDDICB_PRESENT-Struktur beschreibt Zuordnungen, in die Inhalte kopiert und aus denen kopiert wird.

Syntax

typedef struct DXGIDDICB_PRESENT {
  [in] D3DKMT_HANDLE               hSrcAllocation;
  [in] D3DKMT_HANDLE               hDstAllocation;
  [in] void                        *pDXGIContext;
  [in] HANDLE                      hContext;
  [in] UINT                        BroadcastContextCount;
       HANDLE                      BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT];
       D3DKMT_HANDLE               *BroadcastSrcAllocation;
       D3DKMT_HANDLE               *BroadcastDstAllocation;
       UINT                        PrivateDriverDataSize;
       PVOID                       pPrivateDriverData;
       BOOLEAN                     bOptimizeForComposition;
       BOOL                        SyncIntervalOverrideValid;
       DXGI_DDI_FLIP_INTERVAL_TYPE SyncIntervalOverride;
} DXGIDDICB_PRESENT;

Member

[in] hSrcAllocation

Ein D3DKMT_HANDLE Datentyp, der ein Kernelmodushandle für die Quellzuordnung darstellt. Die PfnAllocateCb-Funktion der Microsoft Direct3D-Runtime gibt dieses Handle zurück. Daher sollte der Benutzermodusanzeigetreiber dieses Handle verwenden, um Inhalte aus zu kopieren.

[in] hDstAllocation

Ein D3DKMT_HANDLE Datentyp, der ein Kernelmodushandle für die Zielzuordnung darstellt. hDstAllocation kann null sein, wenn das Ziel unbekannt ist. im Kernelmodus wird das Ziel bestimmt, bevor der Hardwarebefehlsstream über DMA an den Grafikprozessor gesendet wird.

[in] pDXGIContext

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

[in] hContext

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

[in] BroadcastContextCount

Die Anzahl zusätzlicher Kontexte in dem Array, die das BroadcastContext-Mitglied angibt.

[in] BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

Ein Array von Handles für die zusätzlichen Kontexte, an die der aktuelle Vorgang gesendet 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 Display-Miniporttreiber mmio-basierte (Memory Mapped E/O) Flips unterstützen. Um die Unterstützung von MMIO-Flips anzugeben, legt der Display-Miniporttreiber das FlipOnVSyncMmIo-Bitfeldflag im FlipCaps-Element der DXGK_DRIVERCAPS-Struktur fest, wenn die DxgkDdiQueryAdapterInfo-Funktion aufgerufen wird.

Der ursprüngliche Kontext, den das hContext-Element angibt und für den der Benutzermodusanzeigetreiber darstellt, ist kein Element im BroadcastContext-Array . Wenn das BroadcastContext-Array beispielsweise ein Element enthält, sendet der Benutzermodusanzeigetreiber den vorliegenden Vorgang an den besitzereigenen Kontext (hContext) und sendet an diesen zusätzlichen Kontext.

BroadcastSrcAllocation

Zuordnungen, welche Inhalte präsentiert werden.

BroadcastDstAllocation

Wenn nicht 0, stellt die Zielzuordnungen der Gegenwart dar.

PrivateDriverDataSize

Private Treiberdatengröße in Bytes.

pPrivateDriverData

Private Treiberdaten, die an DxgiPresent übergeben werden sollen.

bOptimizeForComposition

DWM ist an der Komposition beteiligt.

SyncIntervalOverrideValid

Das Überschreiben des App-Synchronisierungsintervalls ist gültig.

SyncIntervalOverride

Überschreiben Sie das App-Synchronisierungsintervall.

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

DXGI_DDI_ARG_PRESENT

DXGK_DRIVERCAPS

DxgkDdiQueryAdapterInfo