DXGKARG_COLLECTDBGINFO2-Struktur (d3dkmddi.h)

Artikel
05/23/2024

Die DXGKARG_COLLECTDBGINFO-Struktur beschreibt Informationen für einen Debugbericht, wenn DxgkDdiCollectDbgInfo2 aufgerufen wird.

Syntax

typedef struct _DXGKARG_COLLECTDBGINFO2 {
  UINT                       Reason;
  VOID                       *pBuffer;
  SIZE_T                     BufferSize;
  DXGKARG_COLLECTDBGINFO_EXT *pExtension;
  DXGK_TDR_TYPE              TdrType;
  UINT                       TdrPayloadSize;
  VOID                       *TdrPayload;
} DXGKARG_COLLECTDBGINFO2;

Member

Reason

[in] Der Fehlerprüfungscode , für den Debuginformationen im Puffer zurückgegeben werden sollen, auf den pBuffer zeigt. Dies sind mögliche Werte:

Wert	Bedeutung
VIDEO_TDR_TIMEOUT_DETECTED 0x117	Ein DxgkDdiResetEngine-Vorgang hat einen logischen Adapter zurückgesetzt.
VIDEO_ENGINE_TIMEOUT_DETECTED 0x141	Ein DxgkDdiResetEngine-Vorgang hat einen oder mehrere Knoten innerhalb eines physischen Adapters zurückgesetzt. Verfügbar ab Windows 8.

pBuffer

[out] Ein Zeiger auf einen Puffer, der die Debuginformationen aus dem von Reason angegebenen Grund empfängt.

BufferSize

Die maximale Größe in Bytes, die in den Puffer kopiert werden soll, auf den pBuffer zeigt.

pExtension

Ein Zeiger auf eine vom Betriebssystem zugewiesene DXGKARG_COLLECTDBGINFO_EXT Struktur, die der Treiber optional mit Debugerweiterungsinformationen auffüllt.

TdrType

[in] Ein DXGK_TDR_TYPE Wert, der den Typ der aufgetretenen TDR angibt.

TdrPayloadSize

[in] Die Größe der TDR-Nutzlast in Bytes, auf die TdrPayload verweist.

TdrPayload

[in] Ein Zeiger auf einen Puffer, der die nutzlastspezifisch für bestimmte TdrType-Werte enthält, wie in der folgenden Tabelle angegeben. Dieser Puffer kann NULL sein.

TdrType	Zugeordnete Struktur
DXGK_TDR_TYPE_ENGINE_TIMEOUT	TdrPayload verweist auf eine DXGK_TDR_PAYLOAD_ENGINE_TIMEOUT-Struktur .
DXGK_TDR_TYPE_VSYNC_TIMEOUT	TdrPayload verweist auf eine DXGK_TDR_PAYLOAD_VSYNC_TIMEOUT-Struktur .

Hinweise

Das Layout von DXGKARG_COLLECTDBGINFO2 ist abwärtskompatibel mit DXGKARG_COLLECTDBGINFO , damit die DxgkDdiCollectDbgInfo2-Implementierung vorhandene DxgkDdiCollectDbgInfo-Hilfsprogramme nach Bedarf wiederverwenden kann. Aus diesem Grund weisen die Felder Reason, pBuffer, BufferSize und pExtension die gleiche Semantik auf.

Für einige TDR-Typen (angegeben in TdrType) stellt das Betriebssystem zusätzliche Informationen im TdrPayload-Puffer von TdrPayloadSize-Bytes bereit. Es kann NULL sein, und der Treiber wird erwartet, dass er diesen Fall ohne Absturz behandelt.

Wenn die Nutzlast nicht NULL ist, kann sie in eine Struktur umgewandelt werden, die dem TDR-Typ entspricht. Das Betriebssystem kann diese Strukturen abwärtskompatibel vergrößern und am Ende neue Felder hinzufügen. Der Treiber muss TdrPayloadSize vor dem Zugriff auf TdrPayload-Felder überprüfen, um sicherzustellen, dass das Betriebssystem die gewünschte Nutzlastversion oder höher implementiert.

Arbeitsspeicher, auf den TdrPayload verweist, ist nur für die Dauer des DxgkddiCollectDbgInfo2-Aufrufs gültig. Der Treiber sollte keinen Zeiger auf TdrPayload über das Ende des DxgkddiCollectDbgInfo2-Aufrufs speichern.

Weitere Informationen finden Sie unter Verbesserungen der TDR-Debugfähigkeit.