D3DDDICB_PRESENT-Struktur (d3dumddi.h)
Die D3DDDICB_PRESENT-Struktur beschreibt Zuordnungen, in die Inhalte kopiert werden.
Syntax
typedef struct _D3DDDICB_PRESENT {
[in] D3DKMT_HANDLE hSrcAllocation;
[in] D3DKMT_HANDLE hDstAllocation;
[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;
D3DDDI_FLIPINTERVAL_TYPE SyncIntervalOverride;
} D3DDDICB_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 Benutzermodus-Anzeigetreiber 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. Der Kernelmodus bestimmt das Ziel unmittelbar vor dem DMA des Hardwarebefehlsstreams an den Grafikprozessor.
[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.
BroadcastSrcAllocation
Zuordnungen, welche Inhalte präsentiert werden.
BroadcastDstAllocation
Wenn ungleich 0, stellt die Zielzuordnungen des Vorhandenen dar.
PrivateDriverDataSize
Private Treiberdatengröße in Byte.
pPrivateDriverData
Private Treiberdaten, die an DdiPresent ü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 | d3dumddi.h (include D3dumddi.h) |