DXGK_HISTORY_BUFFER_HEADER Struktur (d3dkmddi.h)

Artikel
02/06/2025

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;

Angehörige

RenderCbSequence

Der Wert der D3DDDICB_RENDERFLAGS.Value Member, der in einem Aufruf der funktion pfnRenderCb verwendet werden soll.

Der Miniporttreiber sollte diesen Wert berechnen und in DXGK_HISTORY_BUFFER_HEADER eingeben, bevor pfnRenderCbaufgerufen wird.

NumTimestamps

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

Der Treiber sollte alle protokollierten Zeitstempel enthalten, auch wenn der Puffer formatiert werden muss, bevor er bei der Ereignisablaufverfolgung für Windows (ETW)-Einrichtung protokolliert wird.

PrivateDataSize

Die Größe von optionalen privaten Daten, die der Treiber speichert, in Byte. 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 Byte sein, um sicherzustellen, dass Zeitstempeldaten an einer 64-Bit-Grenze ausgerichtet werden.

Wenn der Verlaufspuffer nicht formatiert werden muss, wenn der DMA-Puffer die Ausführung abgeschlossen hat, verwendet es PrivateDataSize als direkter Offset vom Header, um auf die Zeitstempel zu verweisen, wenn das DirectX-Kernelsubsystem Protokolle in ETW schreibt.

Reserved

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

Bemerkungen

Nur der Zeitstempelteil des Verlaufspuffers wird zusammen mit der Anzahl der Zeitstempel bei ETW protokolliert. Headerdaten und private Treiberdaten werden nicht als Teil des Zeitstempelpuffers bei ETW protokolliert. Teile der Kopfzeile werden jedoch separat protokolliert.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8.1,WDDM 1.3 und höher
mindestens unterstützte Server-	Windows Server 2012 R2
Header-	d3dkmddi.h (einschließlich D3dkmddi.h)

Siehe auch

D3DDDICB_RENDERFLAGS

DXGK_HISTORY_BUFFER

pfnRenderCb

Freigeben über