DXGK_SUBMITCOMMANDFLAGS Struktur (d3dkmddi.h)
Die DXGK_SUBMITCOMMANDFLAGS Struktur identifiziert In-Bit-Feld-Flags Informationen zu einem DMA-Puffer (Direct Memory Access), der an die Grafikverarbeitungseinheit (GPU) übermittelt werden soll.
Syntax
typedef struct _DXGK_SUBMITCOMMANDFLAGS {
union {
struct {
UINT Paging : 1;
UINT Present : 1;
UINT RedirectedPresent : 1;
UINT NullRendering : 1;
UINT Flip : 1;
UINT FlipWithNoWait : 1;
UINT ContextSwitch : 1;
UINT Resubmission : 1;
UINT VirtualMachineData : 1;
#if ...
UINT Reserved : 23;
#elif
UINT Reserved : 24;
#elif
UINT Reserved : 25;
#else
UINT Reserved : 26;
#endif
};
UINT Value;
};
} DXGK_SUBMITCOMMANDFLAGS;
Angehörige
Paging
[in] Ein UINT-Wert, der angibt, ob der DMA-Puffer ein Pagingpuffer ist, der Pagingvorgänge enthält.
Das Festlegen dieser Einstellung entspricht dem Festlegen des ersten Bits des 32-Bit-Value Members (0x00000001).
Present
[in] Ein UINT-Wert, der angibt, ob der DMA-Puffer einen vorhandenen Vorgang enthält. Der DMA-Puffer wurde durch die DxgkDdiPresent-Funktion des Treibers generiert.
Das Festlegen dieser Einstellung entspricht dem Festlegen des zweiten Bits des 32-Bit-Value Members (0x00000002).
RedirectedPresent
[in] Ein UINT-Wert, der angibt, ob der DMA-Puffer einen umgeleiteten aktuellen Vorgang enthält, bei dem es sich um eine freigegebene Zuordnung handelt, die zum Anzeige-Windows-Manager gehört. Der DMA-Puffer wurde vom DxgkDdiRender-Funktion des Treibers generiert.
Das Festlegen dieser Einstellung entspricht dem Festlegen des dritten Bits des 32-Bit-Value Members (0x00000004).
NullRendering
[in] Ein UINT-Wert, der angibt, ob der Treiber die Einfügung des DMA-Puffers in den Ring simulieren soll (d. a. ob der Treiber den Zaunbruch am Ende des DMA-Puffers generieren soll); Der Treiber sollte jedoch nicht tatsächlich den DMA-Puffer ausführen (rendern). Die NullRendering- Bitfeldkennzeichnung wird nur während der Leistungsuntersuchung und beim Debuggen festgelegt, um ein unendlich schnelles Renderingmodul zu simulieren, das weiterhin den Aufwand der DMA-Pufferübermittlung und -signalisierung ausführen muss. nullRendering- wird während typischer Vorgänge nie festgelegt.
Das Festlegen dieser Einstellung entspricht dem Festlegen des vierten Bits des 32-Bit-Value Members (0x00000008).
Flip
[in] Ein UINT-Wert, der angibt, ob der DMA-Puffer einen Flip-Vorgang enthält.
Das Festlegen dieser Einstellung entspricht dem Festlegen des fünften Bits des 32-Bit-Value Members (0x00000010).
FlipWithNoWait
[in] Ein UINT-Wert, der angibt, ob der DMA-Puffer einen Flip-Vorgang enthält, der ohne integrierte Wartezeit für die nächste vertikale Synchronisierung auftritt.
Das Festlegen dieser Einstellung entspricht dem Festlegen des sechsten Bits des 32-Bit-Value Members (0x00000020).
ContextSwitch
[in] Wird ab Windows 8 unterstützt.
Ein UINT-Wert, der angibt, dass die GPU vom aktuellen ausgeführten Kontext zum Nullkontext wechseln soll.
Ab Windows 8 fordert das Betriebssystem die GPU explizit auf, zum NULL-Kontext zu wechseln, wenn versucht wird, eine Ressource zu verschieben oder zu entfernen, die zum Kontext gehört, der derzeit auf der GPU ausgeführt wird. Die Kontextoptionsanforderung wird ausgeführt, indem ein DMA-Puffer der Länge null mit dem ContextSwitch- Membersatz übermittelt wird.
Wenn der aktuelle Kontext einen Vorgang ausführt, der einen Auslagerungspuffer verwendet hat, wird der Kontextschalterbefehl mit dem Paging Member ebenfalls auf ein Element übermittelt.
Das Festlegen dieser Einstellung entspricht dem Festlegen des siebten Bits des 32-Bit-Value Members (0x00000040).
Resubmission
[in] Gibt an, ob dieses DMA-Paket aufgrund einer früheren Annahme erneut an die GPU gesendet wird. In WDDM 2.0 werden sowohl DXGKARG_SUBMITCOMMAND als auch DxgkDdiSubmitCommandVirtual dieses Flag für die erste DMA-Paketübermittlung auf Null festgelegt und auf eine festgelegt, wenn ein Paket aufgrund eines früheren Vorabstarts erneut gesendet wird. Das Flag wird in WDDM 1.x auf Null festgelegt, unabhängig davon, ob ein Paket zuvor vorgebeutet wurde.
Wird ab Windows 10 unterstützt.
VirtualMachineData
[in] Gibt an, dass die Übermittlung von einem paravirtualisierten Adapter stammt.
Reserved
[in] Dieses Element ist reserviert und sollte auf Null festgelegt werden.
Value
[in] Ein Mitglied in der Union, das DXGK_SUBMITCOMMANDFLAGS enthält, das einen 32-Bit-Wert enthalten kann, der Informationen zum DMA-Puffer identifiziert.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |