DXGKARG_HISTORYBUFFERPRECISION-Struktur (d3dkmddi.h)

  • Artikel

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

Syntax

typedef struct _DXGKARG_HISTORYBUFFERPRECISION {
  UINT32 PrecisionBits;
} DXGKARG_HISTORYBUFFERPRECISION;

Member

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-Grafikkernsubsystem ruft die DxgkDdiFormatHistoryBuffer-Funktion auf, um gültige Daten für die Ausgabe an die ETW-Funktion (Event Tracing for Windows) bereitzustellen. Wenn der Treiber diesen Aufruf verarbeitet, wird ein neuer Genauigkeitswert als Ausgabeparameter der Funktion festgelegt.
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. Der Treiber könnte beispielsweise 64-Bit-Zeitstempel mit einer Genauigkeit von 55 gültigen Bits schreiben. In diesem Fall werden die oberen 9 Bits als Junk-Werte betrachtet und von ETW entfernt.

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

Wenn die Hardware 64-Bit-Zeitstempel unterstützt, aber nur 32 Bits verwendet werden können, muss der Treiber sicherstellen, dass die Daten dem DirectX-Grafikkernsubsystem ordnungsgemäß angezeigt werden. Wenn der Treiber keine anderen Alternativen zur Darstellung der Daten hat, sollte er den Genauigkeitswert angeben, wenn die DxgkDdiFormatHistoryBuffer-Funktion als Nächstes aufgerufen wird.

Hinweise

Bei einem Aufruf der DxgkDdiQueryAdapterInfo-FunktionDXGKARG_QUERYADAPTERINFO die Ausgabedatengröße. OutputDataSize ist:

sizeof(DXGKARG_HISTORYBUFFERPRECISION) * m_DriverCaps.GpuEngineTopology.NbAsymetricProcessingNodes

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

DXGKARG_QUERYADAPTERINFO

DxgkDdiFormatHistoryBuffer

DxgkDdiQueryAdapterInfo