ObRegisterCallbacks-Funktion (wdm.h)

Artikel
02/29/2024

Die ObRegisterCallbacks-Routine registriert eine Liste von Rückrufroutinen für Thread-, Prozess- und Desktophandlevorgänge.

Syntax

NTSTATUS ObRegisterCallbacks(
  [in]  POB_CALLBACK_REGISTRATION CallbackRegistration,
  [out] PVOID                     *RegistrationHandle
);

Parameter

[in] CallbackRegistration

Ein Zeiger auf eine OB_CALLBACK_REGISTRATION-Struktur , die die Liste der Rückrufroutinen und andere Registrierungsinformationen angibt.

[out] RegistrationHandle

Ein Zeiger auf eine Variable, die einen Wert empfängt, der die Gruppe der registrierten Rückrufroutinen identifiziert. Der Aufrufer übergibt diesen Wert an die ObUnRegisterCallbacks-Routine , um die Registrierung der Rückrufe aufzuheben.

Rückgabewert

ObRegisterCallbacks gibt einen NTSTATUS-Wert zurück. Diese Routine gibt möglicherweise einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die angegebenen Rückrufroutinen werden beim System registriert.
STATUS_FLT_INSTANCE_ALTITUDE_COLLISION	Der aufrufende Treiber oder ein anderer Treiber hat bereits Rückrufroutinen für die Höhe registriert, die CallBackRegistration->Altitude angibt. Weitere Informationen zu dieser Höhe finden Sie in der Beschreibung des Höhenelements in OB_CALLBACK_REGISTRATION.
STATUS_INVALID_PARAMETER	Mindestens ein Parameter, die in der Registrierung angegeben wurden, war ungültig. ObRegisterCallbacks kann diesen Fehler zurückgeben, z. B. wenn ein ungültiger Wert für CallBackRegistration->Version angegeben ist oder wenn die Registrierung für Objekttypen versucht wird, die Rückrufroutinen nicht unterstützen.
STATUS_ACCESS_DENIED	Die Rückrufroutinen befinden sich nicht in einem binär signierten Kernelimage.
STATUS_INSUFFICIENT_RESOURCES	Fehler beim Belegen von Speicher

Hinweise

Ein Treiber muss die Registrierung aller Rückrufroutinen aufheben, bevor er entladen wird. Sie können die Registrierung der Rückrufroutine aufheben, indem Sie die Routine ObUnRegisterCallbacks aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows Vista mit Service Pack 1 (SP1) und Windows Server 2008.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Weitere Informationen

OB_CALLBACK_REGISTRATION

ObUnRegisterCallbacks

Freigeben über