KBUGCHECK_REMOVE_PAGES Struktur (wdm.h)

  • Artikel

Die KBUGCHECK_REMOVE_PAGES-Struktur beschreibt mindestens eine Seite mit 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;

Member

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 in der Regel mehrmals aufgerufen werden muss, legt die Routine diesen Member so fest, dass er 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 seinen 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 Members festlegen. Legen Sie dieses Element auf das bitweise OR 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 Fehlerprüfungscodes finden Sie in der Bugcodes.h-Headerdatei, die im WDK enthalten ist.

Address

Gibt die physische oder virtuelle Adresse der Seite oder seiten an, die die Rückrufroutineanforderungen 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 Adresselement angegeben wird. Wenn Count> 1 und Address eine virtuelle Adresse sind, sind die Seiten im virtuellen Speicherraum zusammenhängend. Wenn Count> 1 und Address eine physische Adresse sind, sind die Seiten im physischen Speicherplatz zusammenhängend. Die Rückrufroutine kann diesen Member auf 0 festlegen, um anzugeben, dass keine Seiten aus der Absturzabbilddatei entfernt werden müssen.

Hinweise

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

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

Anforderungen

Anforderung Wert
Header wdm.h