BOOT_DRIVER_CALLBACK_FUNCTION Rückruffunktion (ntddk.h)

  • Artikel

Die BOOT_DRIVER_CALLBACK_FUNCTION Routine eines Starttreibers kann Start-Start-Treiberinitialisierungsereignisse überwachen und Daten an den Kernel zurückgeben, damit der Kernel entscheiden kann, ob die einzelnen Starttreiber initialisiert werden sollen. Der Funktionsprototyp zum Registrieren einer Starttreiberrückrufroutine lautet wie folgt.

Syntax

BOOT_DRIVER_CALLBACK_FUNCTION BootDriverCallbackFunction;

void BootDriverCallbackFunction(
  PVOID CallbackContext,
  BDCB_CALLBACK_TYPE Classification,
  PBDCB_IMAGE_INFORMATION ImageInformation
)
{...}

Parameter

CallbackContext

Der Wert, den der Treiber als CallbackContext-Parameter an IoRegisterBootDriverCallback übergeben hat, als er diese BOOT_DRIVER_CALLBACK_FUNCTION Implementierung registriert hat.

Classification

Ein BDCB_CALLBACK_TYPE Enumerationswert, der entweder die status der Starttreiberinitialisierung identifiziert oder angibt, dass ein Starttreiber initialisiert wird.

ImageInformation

Ein Zeiger auf eine BDCB_IMAGE_INFORMATION-Struktur , die Informationen enthält, die für den Typ des Rückrufs spezifisch sind. Der Strukturtyp hängt vom Wert ab, der für CallbackType übergeben wird, wie in der folgenden Tabelle gezeigt.

Wert von CallbackType Entsprechende zu verwendende Struktur
BdCbStatusUpdate BDCB_STATUS_UPDATE_TYPE
BdCbInitializeImage BDCB_CLASSIFICATION

Rückgabewert

Keine

Bemerkungen

Um über Start-Start-Treiberinitialisierungsvorgänge benachrichtigt zu werden, kann ein ELAM-Treiber (Early Launch Anti-Malware) IoRegisterBootDriverCallback aufrufen. Um die Registrierung aufzuheben, rufen Sie IoUnRegisterBootDriverCallback auf.

Anforderungen

Anforderung Wert
Header ntddk.h
IRQL PASSIVE_LEVEL

Weitere Informationen

IoRegisterBootDriverCallback

IoUnregisterBootDriverCallback