Funzione ObRegisterCallbacks (wdm.h)

  • Articolo

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