ObRegisterCallbacks 函式 (wdm.h)

ObRegisterCallbacks 例程會註冊線程、進程和桌面句柄作業的回呼例程清單。

語法

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

[in] CallbackRegistration

指定回呼例程清單和其他註冊資訊之OB_CALLBACK_REGISTRATION 結構的指標。

[out] RegistrationHandle

接收可識別已註冊回呼例程集之值之變數的指標。呼叫端會將此值傳遞至 ObUnRegisterCallbacks 例程，以取消註冊回呼集。

ObRegisterCallbacks 會傳回NTSTATUS值。此例程可能會傳回下列其中一個值：

傳回碼	Description
STATUS_SUCCESS	指定的回呼例程會向系統註冊。
STATUS_FLT_INSTANCE_ALTITUDE_COLLISION	呼叫驅動程式或其他驅動程式已註冊 CallBackRegistration->高度所指定的高度回呼例程。如需此高度的詳細資訊，請參閱 OB_CALLBACK_REGISTRATION 中高度成員的描述。
STATUS_INVALID_PARAMETER	註冊中指定的一或多個參數無效。 ObRegisterCallbacks 可能會傳回此錯誤，例如，如果指定了 CallBackRegistration->版本的無效值，或嘗試註冊不支援回呼例程的物件類型。
STATUS_ACCESS_DENIED	回呼例程不在已簽署的核心二進位映像中。
STATUS_INSUFFICIENT_RESOURCES	嘗試配置記憶體失敗。

驅動程式必須先取消註冊所有回呼例程，才能卸除。您可以藉由呼叫 ObUnRegisterCallbacks 例程來取消註冊回呼例程。

需求	值
最低支援的用戶端	從 Windows Vista Service Pack 1 (SP1) 和 Windows Server 2008 開始提供。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= APC_LEVEL