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) |