ObRegisterCallbacks-Funktion (wdm.h)

  • Artikel

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