KBUGCHECK_SECONDARY_DUMP_DATA_EX-Struktur (wdm.h)

Artikel
02/27/2024

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;

Member

InBuffer

Zeiger auf einen Puffer, der vom System zugeordnet wird.

InBufferLength

Gibt die Größe des Puffers in Bytes an, die vom InBuffer-Element 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 markieren. Verwenden Sie das tool GuidGen.exe, um GUIDs für Ihren Treiber zu generieren.

OutBuffer

Zeiger auf den Puffer, in den der Treiber seine Absturzabbilddaten schreibt, oder NULL.

OutBufferLength

Gibt die Größe des Puffers in Bytes an, der vom OutBuffer-Element angegeben wurde.

Context

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

Flags

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

KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS

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

KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS

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

KB_ADD_PAGES_FLAG_ADDITIONAL_RANGES_EXIST

Gibt an, dass die Rückrufroutine anfordert, dass sie 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. Beim Eintritt in die Rückrufroutine wird Flags auf 0 (null) initialisiert.

DumpType

Einer der folgenden Speicherabbildtypen.

    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 Fehlerprüfungscode, der den Grund für die Fehlerüberprüfung angibt. Die Rückrufroutine kann anhand dieser Informationen entscheiden, ob der Absturzabbilddatei Seiten hinzugefügt werden sollen. Eine vollständige Liste der Fehlerprüfungscodes finden Sie in der Bugcodes.h-Headerdatei, die im WDK enthalten ist.

BugCheckParameter1

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

BugCheckParameter2

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

BugCheckParameter3

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

BugCheckParameter4

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

Hinweise

Weitere Informationen zu Rückrufroutinen für die Fehlerüberprüfung finden Sie unter Schreiben einer Rückrufroutine für die Fehlerüberprüfung.

Anforderungen

Anforderung	Wert
Header	wdm.h

Weitere Informationen

Schreiben einer Rückrufroutine für die Fehlerüberprüfung. KBUGCHECK_REASON_CALLBACK_ROUTINE

Freigeben über