KBUGCHECK_REMOVE_PAGES Struktur (wdm.h)

Die KBUGCHECK_REMOVE_PAGES Struktur beschreibt eine oder mehrere Seiten von vom Treiber bereitgestellten Daten, die von einer KBUGCHECK_REASON_CALLBACK_ROUTINE Rückrufroutine aus der Absturzabbilddatei entfernt werden sollen.

Syntax

typedef struct _KBUGCHECK_REMOVE_PAGES {
  PVOID     Context;
  ULONG     Flags;
  ULONG     BugCheckCode;
  ULONG_PTR Address;
  ULONG_PTR Count;
} KBUGCHECK_REMOVE_PAGES, *PKBUGCHECK_REMOVE_PAGES;

Angehörige

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 ersten Aufruf der Rückrufroutine ist ContextNULL-.

Flags

Enthält Flags, die die Remove-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_FEATURE_SHIFT       4

KB_REMOVE_PAGES_FEATURE_SHIFT    4

KB_ADD_PAGES_FEATURE_MASK        (0xF << KB_ADD_PAGES_FEATURE_SHIFT)

KB_REMOVE_PAGES_FEATURE_MASK     (0xF << (KB_ADD_PAGES_FEATURE_SHIFT + KB_REMOVE_PAGES_FEATURE_SHIFT))

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.

Address

Gibt die physische oder virtuelle Adresse der Seite oder Seiten an, die von den Rückrufroutinanforderungen aus der Absturzabbilddatei entfernt werden.

Count

Gibt die Anzahl zusammenhängender Seiten an, die aus der Absturzabbilddatei entfernt werden sollen, beginnend mit der virtuellen oder physischen Adresse, die vom Address Member angegeben wird. Wenn Count> 1 und Address eine virtuelle Adresse ist, sind die Seiten im virtuellen Arbeitsspeicher zusammenhängend. Wenn Count> 1 und Address eine physische Adresse ist, sind die Seiten im physischen Arbeitsspeicher zusammenhängend. Die Rückrufroutine kann dieses Element auf Null festlegen, um anzugeben, dass keine Seiten aus der Absturzabbilddatei entfernt werden müssen.

Bemerkungen

In einem Aufruf der KBUGCHECK_REASON_CALLBACK_ROUTINE Rückrufroutine legt das Betriebssystem den parameter Reason auf KbCallbackRemovePagesfest und legt den ReasonSpecificData--Parameter so fest, dass er auf eine KBUGCHECK_REMOVE_PAGES Struktur verweist.

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

Anforderungen

Anforderung	Wert
Header-	wdm.h