Função CmUnRegisterCallback (wdm.h)
A rotina CmUnRegisterCallback cancela o registro de uma rotina RegistryCallback que uma rotina CmRegisterCallback ou CmRegisterCallbackEx registrou anteriormente.
Sintaxe
NTSTATUS CmUnRegisterCallback(
[in] LARGE_INTEGER Cookie
);
Parâmetros
[in] Cookie
Um valor LARGE_INTEGER que identifica a rotina de retorno de chamada para cancelar o registro. CmRegisterCallback forneceu esse valor quando você registrou a rotina de retorno de chamada.
Retornar valor
CmUnRegisterCallback retornará STATUS_SUCCESS se for bem-sucedido ou o código de erro NTSTATUS apropriado se falhar. Se o parâmetro Cookie não corresponder a nenhuma rotina de retorno de chamada registrada, CmUnRegisterCallback retornará STATUS_INVALID_PARAMETER.
Comentários
Um driver que chama CmRegisterCallback ou CmRegisterCallbackEx deve chamar CmUnRegisterCallback antes que o driver seja descarregado.
Um driver não deve chamar CmUnRegisterCallback de sua implementação da rotina RegistryCallback . Essa chamada resultará em um deadlock.
Para obter mais informações sobre CmUnRegisterCallback e filtragem de operações do Registro, consulte Filtrando chamadas do Registro.
Requisitos
| Requisito | Valor |
|---|---|
| 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 de DDI | HwStorPortProhibitedDIs(storport), IrqlExApcLte2(wdm) |