Função CmRegisterCallback (wdm.h)

  • Artigo

A rotina CmRegisterCallback está obsoleta para o Windows Vista e versões posteriores do sistema operacional. Em vez disso, use CmRegisterCallbackEx .

A rotina CmRegisterCallback registra uma rotina RegistryCallback .

Sintaxe

NTSTATUS CmRegisterCallback(
  [in]           PEX_CALLBACK_FUNCTION Function,
  [in, optional] PVOID                 Context,
  [out]          PLARGE_INTEGER        Cookie
);

Parâmetros

[in] Function

Um ponteiro para a rotina RegistryCallback a ser registrada.

[in, optional] Context

Um valor definido pelo driver que o gerenciador de configurações passará como o parâmetro CallbackContext para a rotina RegistryCallback

[out] Cookie

Um ponteiro para uma variável LARGE_INTEGER que recebe o valor que identifica a rotina de retorno de chamada. Quando você cancelar o registro da rotina de retorno de chamada, passe esse valor como o parâmetro Cookie para CmUnRegisterCallback.

Retornar valor

CmRegisterCallback retornará STATUS_SUCCESS se a operação for bem-sucedida ou o código de erro NTSTATUS apropriado se falhar.

Comentários

A rotina CmRegisterCallback está disponível no Windows XP e em versões posteriores do sistema operacional. Para o Windows Vista e versões posteriores do sistema operacional, você deve usar CmRegisterCallbackEx .

Um driver chama CmRegisterCallback para registrar uma rotina RegistryCallback , que é chamada sempre que um thread executa uma operação no registro.

Chame CmUnRegisterCallback para cancelar o registro de uma rotina de retorno de chamada registrada por CmRegisterCallback .

Para obter mais informações sobre CmRegisterCallback e filtragem de operações do Registro, consulte Filtrando chamadas de registro.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows XP e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <=APC_LEVEL
Regras de conformidade da DDI HwStorPortProhibitedDDIs(storport), IrqlExApcLte2(wdm)

Confira também

CmRegisterCallbackEx

CmUnRegisterCallback

RegistryCallback