D3DKMT_RENDERFLAGS-Struktur (d3dkmthk.h)

Die D3DKMT_RENDERFLAGS-Struktur gibt den Typ des Befehlspuffers an, der in einem Aufruf der D3DKMTRender-Funktion gerendert werden soll.

Syntax

typedef struct _D3DKMT_RENDERFLAGS {
  UINT ResizeCommandBuffer : 1;
  UINT ResizeAllocationList : 1;
  UINT ResizePatchLocationList : 1;
  UINT NullRendering : 1;
  UINT PresentRedirected : 1;
  UINT RenderKm : 1;
  UINT RenderKmReadback : 1;
  UINT Reserved : 25;
} D3DKMT_RENDERFLAGS;

Member

ResizeCommandBuffer

Ein UINT-Wert, der angibt, ob die Größe des Befehlspuffers geändert werden soll. Der Treiber fügt die angeforderte Größe in den NewCommandBufferSize-Member der D3DKMT_RENDER-Struktur ein. Da eine Größenänderungsanforderung des Treibers möglicherweise nicht möglich ist, muss der Treiber immer den zurückgegebenen Größenwert überprüfen.

Das Festlegen dieses Elements entspricht dem Festlegen des ersten Bits eines 32-Bit-Werts (0x00000001).

ResizeAllocationList

Ein UINT-Wert, der angibt, ob die Größe der Zuordnungsliste geändert werden soll. Der Treiber fügt die angeforderte Anzahl von Elementen in den NewAllocationListSize-Member der D3DKMT_RENDER-Struktur ein. Da eine Größenänderungsanforderung des Treibers möglicherweise nicht möglich ist, muss der Treiber immer den zurückgegebenen Größenwert überprüfen.

Das Festlegen dieses Elements entspricht dem Festlegen des zweiten Bits eines 32-Bit-Werts (0x00000002).

ResizePatchLocationList

Ein UINT-Wert, der angibt, ob die Größe der Patchspeicherortliste geändert werden soll. Der Treiber fügt die angeforderte Anzahl von Elementen in den NewPatchLocationListSize-Member der D3DKMT_RENDER-Struktur ein. Da eine Größenänderungsanforderung des Treibers möglicherweise nicht möglich ist, muss der Treiber immer den zurückgegebenen Größenwert überprüfen.

Das Festlegen dieses Members entspricht dem Festlegen des dritten Bits eines 32-Bit-Werts (0x00000004).

NullRendering

Ein UINT-Wert, der angibt, ob die Grafikverarbeitungseinheit (GPU) Befehle für den Renderingkontext verarbeiten soll. Das NullRendering-Bitfeldflag wird festgelegt, um die GPU zu informieren, keine Befehle für den Renderingkontext zu verarbeiten. Das NullRendering-Bitfeldflag wird nur während der Leistungsanalyse und beim Debuggen festgelegt, um eine unendlich schnelle Rendering-Engine zu simulieren, die weiterhin den Mehraufwand für die DMA-Pufferübermittlung und -signalisierung ausführen muss. NullRendering wird bei typischen Vorgängen nie festgelegt.

Das Festlegen dieses Elements entspricht dem Festlegen des vierten Bits des 32-Bit-Wertmembers (0x00000008).

PresentRedirected

Ein UINT-Wert, der angibt, ob der aktuelle Befehl umgeleitet werden soll. Der Befehl enthält eine Vervollständigung eines Frames, obwohl der Befehl im OpenGl ICD abgeschlossen wurde.

Das Festlegen dieses Elements entspricht dem Festlegen des fünften Bits eines 32-Bit-Werts (0x00000010).

RenderKm

Unterstützt in Windows 7 und höheren Versionen.

Ein UINT-Wert, der angibt, ob die OpenGL ICD einen Zeiger auf den Befehlspuffer bereitstellt, der im ICD-Aufruf der D3DKMTRender-Funktion gerendert werden soll. Wenn dieses Flag festgelegt ist, ruft die Runtime die DxgkDdiRender-Funktion des Anzeigeminiporttreibers nicht auf. Wenn dieses Flag festgelegt ist, ruft die Runtime die DxgkDdiRenderKm-Funktion des Anzeigeminiporttreibers auf.

Das Festlegen dieses Elements entspricht dem Festlegen des sechsten Bits eines 32-Bit-Werts (0x00000020).

RenderKmReadback

Reserved

Dieser Member ist reserviert und sollte auf 0 (null) festgelegt werden. Das Festlegen dieses Elements entspricht dem Festlegen der verbleibenden 26 Bits (0xFFFFFFC0) eines 32-Bit-Werts auf Nullen.

Anforderungen

Weitere Informationen

D3DKMT_RENDER