Freigeben über


DXGKARG_HISTORYBUFFERPRECISION Struktur (d3dkmddi.h)

Gibt Informationen zur Genauigkeit von Verlaufspufferdaten an, die vom Anzeigeminiporttreiber verwendet werden.

Syntax

typedef struct _DXGKARG_HISTORYBUFFERPRECISION {
  UINT32 PrecisionBits;
} DXGKARG_HISTORYBUFFERPRECISION;

Angehörige

PrecisionBits

Die Anzahl der gültigen Bits, die in jedem Zeitstempel verwendet werden. Diese Zahl enthält keine Bits, die für Junk-Werte verwendet werden.

Dieser Genauigkeitswert weist drei gültige Bereiche auf:

Wert Bedeutung
0 Keine Bits enthalten nützliche Daten, und das DirectX-Grafik-Kernelsubsystem ruft die DxgkDdiFormatHistoryBuffer--Funktion auf, um gültige Daten bereitzustellen, die an die Ereignisablaufverfolgung für Windows (ETW)-Einrichtung ausgegeben werden. Wenn der Treiber diesen Aufruf verarbeitet, legt er einen neuen Genauigkeitswert als Ausgabeparameter der Funktion fest.
32 Der Treiber sollte 32-Bit-Zeitstempel mit der vollen Genauigkeit von 32 Bit protokollieren.
33–64 Der Treiber sollte 64-Bit-Zeitstempel protokollieren. Dieser Wert definiert die Anzahl der Bits, die zum Speichern von Daten pro Zeitstempel verwendet werden.
Um die Kosten für die Formatierung der Daten zu reduzieren, kann der Treiber Junk-Werte in die 64-Bit-Zeitstempel einschließen. Beispielsweise könnte der Treiber 64-Bit-Zeitstempel mit einer Genauigkeit von 55 gültigen Bits schreiben. In diesem Fall gelten die oberen 9 Bits als Junk-Werte und werden von ETW entfernt.

Werte zwischen 0 und 32 werden nicht unterstützt und ungültig.

Wenn die Hardware 64-Bit-Zeitstempel unterstützt, aber nur 32 Bit verwendbar sind, muss der Treiber sicherstellen, dass die Daten dem DirectX-Grafik-Kernel-Subsystem korrekt angezeigt werden. Wenn der Treiber keine anderen Alternativen zum Darstellen der Daten aufweist, sollte er den Genauigkeitswert angeben, wenn die DxgkDdiFormatHistoryBuffer--Funktion als nächstes aufgerufen wird.

Bemerkungen

In einem Aufruf der DxgkDdiQueryAdapterInfo Funktion, die Ausgabedatengröße DXGKARG_QUERYADAPTERINFO.OutputDataSizelautet:

sizeof(DXGKARG_HISTORYBUFFERPRECISION) * m_DriverCaps.GpuEngineTopology.NbAsymetricProcessingNodes

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

DXGKARG_QUERYADAPTERINFO

DxgkDdiFormatHistoryBuffer

DxgkDdiQueryAdapterInfo