KBUGCHECK_ADD_PAGES Struktur (wdm.h)
Die KBUGCHECK_ADD_PAGES Struktur beschreibt eine oder mehrere Seiten von vom Treiber bereitgestellten Daten, die von einer KBUGCHECK_REASON_CALLBACK_ROUTINE Rückruffunktion in die Absturzabbilddatei geschrieben werden sollen.
Syntax
typedef struct _KBUGCHECK_ADD_PAGES {
PVOID Context;
ULONG Flags;
ULONG BugCheckCode;
ULONG_PTR Address;
ULONG_PTR Count;
} KBUGCHECK_ADD_PAGES, *PKBUGCHECK_ADD_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 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.
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 die Rückrufroutineanforderungen der Absturzabbilddatei hinzugefügt werden.
Count
Gibt die Anzahl zusammenhängender Seiten an, die der Absturzabbilddatei hinzugefügt 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 der Absturzabbilddatei keine Seiten hinzugefügt werden müssen.
Bemerkungen
In einem Aufruf der KbCallbackAddPages- Rückrufroutine legt das Betriebssystem den Parameter Reason auf KbCallbackAddPagesfest und legt den parameter ReasonSpecificData so fest, dass er auf eine KBUGCHECK_ADD_PAGES Struktur verweist.
Weitere Informationen zur Verwendung dieser Struktur finden Sie unter Schreiben einer Fehlerüberprüfungsroutine und KBUGCHECK_REASON_CALLBACK_ROUTINE Rückruffunktion.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in Windows Server 2008 und höheren Versionen von Windows. |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |