struttura KBUGCHECK_SECONDARY_DUMP_DATA_EX (wdm.h)

Articolo
02/07/2025

La struttura KBUGCHECK_SECONDARY_DUMP_DATA_EX descrive i dati multiparti da scrivere KBUGCHECK_REASON_CALLBACK_ROUTINE routine di callback nel file di dump di arresto anomalo del sistema.

Sintassi

typedef struct _KBUGCHECK_SECONDARY_DUMP_DATA_EX {
  PVOID     InBuffer;
  ULONG     InBufferLength;
  ULONG     MaximumAllowed;
  GUID      Guid;
  PVOID     OutBuffer;
  ULONG     OutBufferLength;
  PVOID     Context;
  ULONG     Flags;
  ULONG     DumpType;
  ULONG     BugCheckCode;
  ULONG_PTR BugCheckParameter1;
  ULONG_PTR BugCheckParameter2;
  ULONG_PTR BugCheckParameter3;
  ULONG_PTR BugCheckParameter4;
} KBUGCHECK_SECONDARY_DUMP_DATA_EX, *PKBUGCHECK_SECONDARY_DUMP_DATA_EX;

Membri

InBuffer

Puntatore a un buffer allocato dal sistema.

InBufferLength

Specifica le dimensioni del buffer, in byte, specificate dal membro InBuffer.

MaximumAllowed

Specifica la quantità massima di dati che la routine KBUGCHECK_REASON_CALLBACK_ROUTINE può scrivere nel file di dump di arresto anomalo del sistema.

Guid

Specifica un GUID che identifica i dati del dump di arresto anomalo del driver. I driver devono usare GUID univoci per contrassegnare i dati di dump di arresto anomalo del sistema. Usare lo strumento GuidGen.exe per generare GUID per il driver.

OutBuffer

Puntatore al buffer in cui il driver scrive i dati di dump di arresto anomalo del driver o NULL.

OutBufferLength

Specifica le dimensioni del buffer, in byte, specificate dal membro OutBuffer.

Context

Contiene dati di contesto privato per l'uso esclusivo della routine di callback. La routine di callback può impostare questo membro su qualsiasi valore. In genere, se la routine di callback deve essere chiamata più volte, la routine imposta questo membro in modo che punti a un buffer fornito dal driver durante la chiamata iniziale. Durante le chiamate successive, la routine di callback può leggere il contenuto precedente di questo buffer e aggiornarne il contenuto. Prima della chiamata iniziale alla routine di callback, Context è NULL.

Flags

Contiene flag che descrivono la richiesta di aggiunta pagina. La routine di callback deve impostare il valore di questo membro. Impostare questo membro sull'OR bit per bit di uno o più dei bit di flag seguenti:

KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS

Indica che il membro Address contiene un indirizzo virtuale.

KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS

Indica che il membro Address contiene un indirizzo fisico.

KB_ADD_PAGES_FLAG_ADDITIONAL_RANGES_EXIST

Indica che la routine di callback richiede che venga chiamata di nuovo in modo che possa aggiungere altre pagine.

La routine di callback deve impostare il flag di KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS o il flag di KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS, ma non entrambi. Nella voce della routine di callback, Flag viene inizializzato su zero.

DumpType

Uno dei tipi di dump seguenti.

    DUMP_TYPE_INVALID           = -1,
    DUMP_TYPE_UNKNOWN           = 0,
    DUMP_TYPE_FULL              = 1,
    DUMP_TYPE_SUMMARY           = 2,
    DUMP_TYPE_HEADER            = 3,
    DUMP_TYPE_TRIAGE            = 4,
    DUMP_TYPE_BITMAP_FULL       = 5,
    DUMP_TYPE_BITMAP_KERNEL     = 6,
    DUMP_TYPE_AUTOMATIC         = 7

BugCheckCode

Contiene un codice di controllo dei bug, che specifica il motivo del controllo dei bug. La routine di callback può utilizzare queste informazioni per decidere se aggiungere pagine 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

Per altre informazioni sulle routine di callback di controllo dei bug, vedere Scrittura di una routine di callback di controllo dei bug.

Fabbisogno

Requisito	Valore
intestazione	wdm.h

Vedere anche

scrittura di una routine di callback di controllo dei bug. KBUGCHECK_REASON_CALLBACK_ROUTINE

Condividi tramite