Compartilhar via


Função CmRegisterCallback (wdm.h)

A rotina de cmRegisterCallback é obsoleta para Windows Vista e versões posteriores do sistema operacional. Use CmRegisterCallbackEx.

A rotina cmRegisterCallback registra uma rotina de 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.

Valor de retorno

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

Observações

A rotina de cmRegisterCallback está disponível no Windows XP e 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 de 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 que CmRegisterCallback registrado.

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

Requisitos

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

Consulte também

CmRegisterCallbackEx

CmUnRegisterCallback

RegistryCallback