Função CmUnRegisterCallback (wdm.h)

  • Artigo

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)

Confira também

CmRegisterCallback

CmRegisterCallbackEx

RegistryCallback