DXGIDDICB_PRESENT-Struktur (dxgiddi.h)
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) |