Funzione ObRegisterCallbacks (wdm.h)

Articolo
03/08/2023

La routine ObRegisterCallbacks registra un elenco di routine di callback per operazioni di thread, processo e gestione desktop.

Sintassi

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

Parametri

[in] CallbackRegistration

Puntatore a una struttura OB_CALLBACK_REGISTRATION che specifica l'elenco di routine di callback e altre informazioni di registrazione.

[out] RegistrationHandle

Puntatore a una variabile che riceve un valore che identifica il set di routine di callback registrate. Il chiamante passa questo valore alla routine ObUnRegisterCallbacks per annullare la registrazione del set di callback.

Valore restituito

ObRegisterCallbacks restituisce un valore NTSTATUS. Questa routine potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Le routine di callback specificate vengono registrate con il sistema.
STATUS_FLT_INSTANCE_ALTITUDE_COLLISION	Il driver chiamante o un altro driver ha già registrato routine di callback perl'altitudine specificata da CallBackRegistration-> Altitude. Per altre informazioni su questa altitudine, vedere la descrizione del membro Altitudine in OB_CALLBACK_REGISTRATION.
STATUS_INVALID_PARAMETER	Uno o più dei parametri specificati nella registrazione non sono validi. ObRegisterCallbacks potrebbe restituire questo errore, ad esempio se viene specificato un valore non valido per CallBackRegistration->Version o se la registrazione viene tentata per i tipi di oggetti che non supportano le routine di callback.
STATUS_ACCESS_DENIED	Le routine di callback non risiedono in un'immagine binaria del kernel firmata.
STATUS_INSUFFICIENT_RESOURCES	Tentativo di allocazione della memoria non riuscito.

Commenti

Un driver deve annullare la registrazione di tutte le routine di callback prima di scaricarlo. È possibile annullare la registrazione della routine di callback chiamando la routine ObUnRegisterCallbacks .

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows Vista con Service Pack 1 (SP1) e Windows Server 2008.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Vedi anche

OB_CALLBACK_REGISTRATION

ObUnRegisterCallbacks

Condividi tramite