DXGKARG_COLLECTDIAGNOSTICINFO Struktur (dispmprt.h)

Artikel
02/06/2025

Wird von der DXGKDDI_COLLECTDIAGNOSTICINFO Rückruffunktion verwendet, um private Treiberinformationen aus verschiedenen Gründen zu sammeln.

Beispielsweise ruft das Betriebssystem die DXGKDDI_COLLECTDIAGNOSTICINFO Rückruffunktion auf, wenn Diagnoseinformationen benötigt werden, während der Typ der angeforderten Informationen bereitgestellt wird (DXGK_DIAGNOSTICINFO_TYPE). Der Treiber sollte alle privaten Informationen sammeln, um das Problem zu untersuchen und an das Betriebssystem zu übermitteln.

Syntax

typedef struct _DXGKARG_COLLECTDIAGNOSTICINFO {
  [in, optional]  HANDLE                   hAdapter;
  [in]            DXGK_DIAGNOSTICINFO_TYPE Type;
                  CHAR                     BucketingString[DXGK_DUMP_BUCKETING_BUFFER_SIZE];
                  CHAR                     DescriptionString[DXGK_DUMP_DESCRIPTION_BUFFER_SIZE];
  union {
    [out, optional] PVOID pReserved;
  };
  [in]            UINT                     BufferSizeIn;
  [out]           UINT                     BufferSizeOut;
  [out]           PVOID                    pBuffer;
} DXGKARG_COLLECTDIAGNOSTICINFO;

Angehörige

[in, hAdapter

Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist.

Vor WDDM 2.6 hat die DxgkDdiAddDevice--Funktion des Display-Miniporttreibers dieses Handle für das DirectX-Grafikkernsubsystem bereitgestellt. Dieser Parameter ist optional und kann NULL sein, wenn der Treiber das Handle nicht für das Betriebssystem bereitstellt.

[in] Type

Ein DXGK_DIAGNOSTICINFO_TYPE Enumerationswert, der den Typ der Informationen angibt, die der Treiber erfassen muss.

[out] BucketingString[DXGK_DUMP_BUCKETING_BUFFER_SIZE]

Ein puffer mit fester Größe, der für eine Zeichenfolge bereitgestellt wird, die vom Treiber verwendet werden soll, um das Problem für Bucketing-Zwecke zu identifizieren. Diese Zeichenfolge sollte zwischen Treiberversionen für dasselbe Problem konsistent sein, sodass sie keine Elemente wie Quellverweise, Treiberversionen oder Instanzspezifische Details wie Zaunnummern oder Ziel-IDs enthalten sollte. Es kann Informationen wie einen Bezeichner der internen Unterkomponente enthalten, die fehlgeschlagen ist, oder den Namen eines Moduls, z. B. mismatched_driver_ihvxseries.sys. Die gültigen Codes sind 0x21-0x7E und der Unterstrich (0x5f) sollte anstelle des Leerzeichens (0x20) verwendet werden.

[out, DescriptionString[DXGK_DUMP_DESCRIPTION_BUFFER_SIZE]

Ein für eine Zeichenfolge bereitgestellter Puffer mit fester Größe, den der Treiber verwenden sollte, um instanzspezifische Details zu beschreiben, die nicht zum Bucketing verwendet werden, können jedoch verwendet werden, um weitere Details zu einem bestimmten Problem anzugeben, z. B. mismatched_driver_versions_kmd_10.22.1111.1121,_ihvxseries:10.22.1111.1122. Die gültigen Codes sind 0x21-0x7E und der Unterstrich (0x5f) sollte anstelle des Leerzeichens (0x20) verwendet werden.

[out, pReserved

Ein Zeiger auf VOID in einer nicht benannten Union, die als Platzhalter für einen Zeiger auf ein typspezifisches Argument reserviert ist, das vom Betriebssystem für einige Typenbereitgestellt wird. Dieser Wert ist NULL für Typen, die keine erweiterten Informationen erfordern.

[in] BufferSizeIn

Eine Variable, die die Größe des vom Betriebssystem zugewiesenen Puffers in Bytes bereitstellt. Für Type Wert von DXGK_DI_ADDDEVICE und DXGK_DI_STARTDEVICE wird die Größe um 0x80000.

[out] BufferSizeOut

Eine Variable, die der Treiber mit einer tatsächlichen Größe aktualisieren soll, die mit seinen privaten Daten gefüllt ist. Wenn keine privaten Daten bereitgestellt werden, sollte der Treiber der Variablen 0 zuweisen.

[out] pBuffer

Ein Zeiger auf einen Puffer, der die privaten Treiberdaten empfängt.