KBUGCHECK_SECONDARY_DUMP_DATA_EX Struktur (wdm.h)

Artikel
02/07/2025

Die KBUGCHECK_SECONDARY_DUMP_DATA_EX Struktur beschreibt mehrteilige Daten, die von KBUGCHECK_REASON_CALLBACK_ROUTINE Rückrufroutine in die Absturzabbilddatei geschrieben werden sollen.

Syntax

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;

Angehörige

InBuffer

Zeiger auf einen Puffer, der vom System zugewiesen wird.

InBufferLength

Gibt die Größe des Puffers in Byte an, die durch das InBuffer Member angegeben wird.

MaximumAllowed

Gibt die maximale Datenmenge an, die die KBUGCHECK_REASON_CALLBACK_ROUTINE Routine in die Absturzabbilddatei schreiben kann.

Guid

Gibt eine GUID an, die die Absturzabbilddaten des Treibers identifiziert. (Treiber müssen eindeutige GUIDs verwenden, um ihre Absturzabbilddaten zu kennzeichnen. Verwenden Sie das tool GuidGen.exe, um GUIDs für Ihren Treiber zu generieren.

OutBuffer

Zeigen Sie auf den Puffer, in dem der Treiber seine Absturzabbilddaten schreibt, oder NULL-.

OutBufferLength

Gibt die Größe des Puffers in Byte an, die vom OutBuffer-element angegeben wurde.

Context

Enthält private Kontextdaten für die exklusive Verwendung der Rückrufroutine. Die Rückrufroutine kann dieses Element auf einen beliebigen Wert festlegen. Wenn die Rückrufroutine in der Regel mehrere Mal aufgerufen werden muss, legt die Routine dieses Element fest, dass er während des anfänglichen Aufrufs auf einen vom Treiber bereitgestellten Puffer verweist. Bei nachfolgenden Aufrufen kann die Rückrufroutine den vorherigen Inhalt dieses Puffers lesen und deren Inhalt aktualisieren. Vor dem anfänglichen Aufruf der Rückrufroutine ist Context NULL.

Flags

Enthält Flags, die die Add-Page-Anforderung beschreiben. Die Rückrufroutine muss den Wert dieses Elements festlegen. Legen Sie dieses Element auf das bitweise ODER eines oder mehrerer der folgenden Flagbits fest:

KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS

Gibt an, dass das Address Member eine virtuelle Adresse enthält.

KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS

Gibt an, dass das Address Member eine physische Adresse enthält.

KB_ADD_PAGES_FLAG_ADDITIONAL_RANGES_EXIST

Gibt an, dass die Rückrufroutine erneut aufgerufen wird, damit weitere Seiten hinzugefügt werden können.

Die Rückrufroutine muss entweder das KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS Flag oder das KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS Flag festlegen, aber nicht beides. Bei der Eingabe in die Rückrufroutine wird Flags auf Null initialisiert.

DumpType

Einer der folgenden Dumptypen.

    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

Enthält einen Fehlerüberprüfungscode, der den Grund für die Fehlerüberprüfung angibt. Die Rückrufroutine kann diese Informationen verwenden, um zu entscheiden, ob der Absturzabbilddatei Seiten hinzugefügt werden sollen. Eine vollständige Liste der Fehlerüberprüfungscodes finden Sie in der Headerdatei Bugcodes.h, die in der WDK enthalten ist.

BugCheckParameter1

Fehlerüberprüfungsparameter 1. Die Fehlerüberprüfungsparameter informieren den Rückruf über die Fehlerüberprüfungsparameter, die an KeBugcheckEx übergeben wurden.

BugCheckParameter2

Fehlerüberprüfungsparameter 2. Die Fehlerüberprüfungsparameter informieren den Rückruf über die Fehlerüberprüfungsparameter, die an KeBugcheckEx übergeben wurden.

BugCheckParameter3

Fehlerüberprüfungsparameter 3. Die Fehlerüberprüfungsparameter informieren den Rückruf über die Fehlerüberprüfungsparameter, die an KeBugcheckEx übergeben wurden.

BugCheckParameter4

Fehlerüberprüfungsparameter 4. Die Fehlerüberprüfungsparameter informieren den Rückruf über die Fehlerüberprüfungsparameter, die an KeBugcheckEx übergeben wurden.

Bemerkungen

Weitere Informationen zu Fehlerüberprüfungsrückrufroutinen finden Sie unter Schreiben einer Fehlerüberprüfungsrückrufroutine.

Anforderungen

Anforderung	Wert
Header-	wdm.h

Siehe auch

Schreiben einer Fehlerüberprüfungsroutine. KBUGCHECK_REASON_CALLBACK_ROUTINE

Freigeben über