KBUGCHECK_ADD_PAGES-Struktur (wdm.h)

Artikel
02/27/2024

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

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 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 Adresselement eine physische Adresse enthält.

KB_ADD_PAGES_FLAG_ADDITIONAL_RANGES_EXIST

Gibt an, dass die Rückrufroutine den Erneuten Aufruf anfordert, 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 Einstieg in die Rückrufroutine wird Flags mit 0 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 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 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 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 der Absturzabbilddatei keine Seiten hinzugefügt werden müssen.

Hinweise

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

Weitere Informationen zur Verwendung dieser Struktur finden Sie unter Schreiben einer Rückrufroutine für die Fehlerüberprüfung und KBUGCHECK_REASON_CALLBACK_ROUTINE Rückruffunktion.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Wird in Windows Server 2008 und höheren Versionen von Windows unterstützt.
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)

Weitere Informationen

Schreiben einer Fehlerüberprüfungs-Rückrufroutine.

Freigeben über