Função CmRegisterCallback (wdm.h)
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) |