KBUGCHECK_TRIAGE_DUMP_DATA struttura (wdm.h)

Articolo
02/29/2024

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;

Members

DataArray

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

Flags

Flag passati al callback.

KB_TRIAGE_DUMP_DATA_FLAG_BUGCHECK_ACTIVE 0x00000001

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

MaxVirtMemSize

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

BugCheckCode

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

BugCheckParameter1

Controllo bug 1. I parametri di controllo dei bug informano il callback dei parametri di bugcheck passati a KeBugcheckEx.

BugCheckParameter2

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

BugCheckParameter3

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

BugCheckParameter4

Controllo bug 4. I parametri di controllo dei bug informano il callback dei parametri di bugcheck passati a KeBugcheckEx.

Commenti

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 dump.

Requisiti

Requisito	Valore
Intestazione	wdm.h

Vedi anche

Scrittura di una routine di controllo bug.

Condividi tramite