Função ObRegisterCallbacks (wdm.h)

  • Artigo

A rotina ObRegisterCallbacks registra uma lista de rotinas de retorno de chamada para operações de thread, processo e identificador de área de trabalho.

Sintaxe

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

Parâmetros

[in] CallbackRegistration

Um ponteiro para uma estrutura OB_CALLBACK_REGISTRATION que especifica a lista de rotinas de retorno de chamada e outras informações de registro.

[out] RegistrationHandle

Um ponteiro para uma variável que recebe um valor que identifica o conjunto de rotinas de retorno de chamada registradas. O chamador passa esse valor para a rotina ObUnRegisterCallbacks para cancelar o registro do conjunto de retornos de chamada.

Retornar valor

ObRegisterCallbacks retorna um valor NTSTATUS. Essa rotina pode retornar um dos seguintes valores:

Código de retorno Descrição
STATUS_SUCCESS
 As rotinas de retorno de chamada especificadas são registradas no sistema.
STATUS_FLT_INSTANCE_ALTITUDE_COLLISION
 O driver de chamada ou outro driver já registrou rotinas de retorno de chamada para a altitude especificada por CallBackRegistration->Altitude . Para obter mais informações sobre essa altitude, consulte a descrição do membro Altitude em OB_CALLBACK_REGISTRATION.
STATUS_INVALID_PARAMETER
 Um ou mais dos parâmetros especificados no registro eram inválidos. ObRegisterCallbacks poderá retornar esse erro, por exemplo, se um valor inválido para CallBackRegistration->Version for especificado ou se o registro for tentado para tipos de objeto que não dão suporte a rotinas de retorno de chamada.
STATUS_ACCESS_DENIED
 As rotinas de retorno de chamada não residem em uma imagem binária de kernel assinada.
STATUS_INSUFFICIENT_RESOURCES
 Falha ao tentar alocar memória.

Comentários

Um driver deve cancelar o registro de todas as rotinas de retorno de chamada antes de descarregar. Você pode cancelar o registro da rotina de retorno de chamada chamando a rotina ObUnRegisterCallbacks .

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows Vista com Service Pack 1 (SP1) e Windows Server 2008.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Confira também

OB_CALLBACK_REGISTRATION

ObUnRegisterCallbacks