DXGK_HISTORY_BUFFER_HEADER Struktur (d3dkmddi.h)

  • Artikel

Gibt an, wie Daten in einem DXGK_HISTORY_BUFFER Verlaufspuffer gespeichert werden.

Syntax

typedef struct _DXGK_HISTORY_BUFFER_HEADER {
  UINT32 RenderCbSequence;
  UINT32 NumTimestamps;
  UINT32 PrivateDataSize;
  UINT32 Reserved;
} DXGK_HISTORY_BUFFER_HEADER;

Member

RenderCbSequence

Der Wert des D3DDDICB_RENDERFLAGS. Wertmember , der in einem Aufruf der PfnRenderCb-Funktion verwendet werden soll.

Der Anzeigeminiporttreiber sollte diesen Wert berechnen und in DXGK_HISTORY_BUFFER_HEADER eingeben, bevor pfnRenderCb aufgerufen wird.

NumTimestamps

Die Anzahl der Zeitstempel, die sich im Verlaufspuffer befinden, wenn der DMA-Puffer seine Ausführung abgeschlossen hat.

Der Treiber sollte alle Zeitstempel enthalten, die protokolliert werden, auch wenn der Puffer formatiert werden muss, bevor er bei der ETW-Einrichtung (Event Tracing for Windows) protokolliert wird.

PrivateDataSize

Die Größe der optionalen privaten Daten, die der Treiber speichert, in Bytes. Der Treiber kann diese Daten für jeden Zweck verwenden.

Wenn null, muss der Treiber keine privaten Daten im Verlaufspuffer speichern.

Hinweis Dieser Wert sollte ein Vielfaches von 8 Bytes sein, um sicherzustellen, dass Zeitstempeldaten an einer 64-Bit-Grenze ausgerichtet sind.
 
Wenn der Verlaufspuffer nicht formatiert werden muss, wenn der DMA-Puffer seine Ausführung abgeschlossen hat, verwendet das DirectX-Grafikkernsubsystem Protokolle in ETW, es verwendet PrivateDataSize als direkten Offset aus dem Header, um auf die Zeitstempel zu verweisen.

Reserved

Reserviert für die Systemverwendung und muss auf 0 festgelegt werden.

Hinweise

Nur der Zeitstempelteil des Verlaufspuffers und die Anzahl der Zeitstempel werden bei ETW protokolliert. Headerdaten und private Treiberdaten werden nicht als Teil des Zeitstempelpuffers bei ETW protokolliert. Teile des Headers werden jedoch separat protokolliert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1, WDDM 1.3 und höher
Unterstützte Mindestversion (Server) Windows Server 2012 R2
Kopfzeile d3dkmddi.h (einschließlich D3dkmddi.h)

Weitere Informationen

D3DDDICB_RENDERFLAGS

DXGK_HISTORY_BUFFER

pfnRenderCb