struttura KBUGCHECK_TRIAGE_DUMP_DATA (wdm.h)

Articolo
02/07/2025

La struttura _KBUGCHECK_TRIAGE_DUMP_DATA descrive i dati di dump usati insieme alla routine di callback KBUGCHECK_REASON_CALLBACK_ROUTINE.

Sintassi

typedef struct _KBUGCHECK_TRIAGE_DUMP_DATA {
  PKTRIAGE_DUMP_DATA_ARRAY DataArray;
  ULONG                    Flags;
  ULONG                    MaxVirtMemSize;
  ULONG                    BugCheckCode;
  ULONG_PTR                BugCheckParameter1;
  ULONG_PTR                BugCheckParameter2;
  ULONG_PTR                BugCheckParameter3;
  ULONG_PTR                BugCheckParameter4;
} KBUGCHECK_TRIAGE_DUMP_DATA, *PKBUGCHECK_TRIAGE_DUMP_DATA;

Membri

DataArray

Puntatore a una struttura _KBUGCHECK_TRIAGE_DUMP_DATA. Questo è il metodo usato dal callback per fornire la matrice di dati del blocco di valutazione creata.

Flags

Flag passati al callback.

KB_TRIAGE_DUMP_DATA_FLAG_BUGCHECK_ACTIVE 0x00000001

Indica che il callback viene richiamato durante un controllo bug. Attualmente, questo flag deve essere sempre impostato.

MaxVirtMemSize

Le dimensioni massime della memoria virtuale in byte consentite al callback possono essere aggiunte al dump. Le dimensioni cumulative delle aree descritte nella matrice di dati non devono superare questa dimensione.

BugCheckCode

Questo valore indica al callback il codice di controllo di bug passato a KeBugcheckEx. La routine di callback può utilizzare queste informazioni per decidere se aggiungere memoria al file di dump di arresto anomalo del sistema. Per un elenco completo dei codici di controllo dei bug, vedere il file di intestazione Bugcodes.h incluso in WDK.

BugCheckParameter1

Bug Check Parametro 1. I parametri di controllo dei bug informano il callback dei parametri di controllo bug passati a KeBugcheckEx.

BugCheckParameter2

Parametro di controllo dei bug 2. I parametri di controllo dei bug informano il callback dei parametri di controllo bug passati a KeBugcheckEx.

BugCheckParameter3

Parametro di controllo dei bug 3. I parametri di controllo dei bug informano il callback dei parametri di controllo bug passati a KeBugcheckEx.

BugCheckParameter4

Bug Check Parametro 4. I parametri di controllo dei bug informano il callback dei parametri di controllo bug passati a KeBugcheckEx.

Osservazioni

Il driver riceve una struttura di questo tipo come parametro alla relativa routine di callback KBUGCHECK_REASON_CALLBACK_ROUTINE.

Dalla routine di callback, il driver chiama la funzione KeAddTriageDumpDataBlock per modificare una matrice di dati di dump.

Fabbisogno

Requisito	Valore
intestazione	wdm.h

Vedere anche

scrittura di una routine di callback di controllo dei bug.

Condividi tramite