Função CmRegisterCallbackEx (wdm.h)

Artigo
02/07/2025

A rotina CmRegisterCallbackEx registra uma rotina de RegistryCallback.

Sintaxe

NTSTATUS CmRegisterCallbackEx(
  [in]           PEX_CALLBACK_FUNCTION Function,
  [in]           PCUNICODE_STRING      Altitude,
  [in]           PVOID                 Driver,
  [in, optional] PVOID                 Context,
  [out]          PLARGE_INTEGER        Cookie,
                 PVOID                 Reserved
);

Parâmetros

[in] Function

Um ponteiro para a rotina registryCallback a ser registrada.

[in] Altitude

Um ponteiro para uma estrutura UNICODE_STRING. Essa estrutura deve conter uma cadeia de caracteres que represente o de altitude do driver de minifiltro de chamada. Para obter mais informações, consulte Comentários.

[in] Driver

Um ponteiro para a estrutura DRIVER_OBJECT que representa o driver.

[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.

Reserved

Esse parâmetro é reservado para uso futuro.

Valor de retorno

CmRegisterCallbackEx retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa rotina poderá retornar um dos seguintes valores de NTSTATUS:

Código de retorno	Descrição
STATUS_FLT_INSTANCE_ALTITUDE_COLLISION	O driver de chamada ou outro driver já registrou uma rotina de RegistryCallback para a altitude especificada.
STATUS_INSUFFICIENT_RESOURCES	Falha na tentativa de alocar memória.

Observações

A rotina de CmRegisterCallbackEx do está disponível a partir do Windows Vista.

Um driver pode chamar CmRegisterCallback ou CmRegisterCallbackEx para registrar uma rotina de RegistryCallback, que é chamada sempre que um thread executa uma operação no registro.

O parâmetro Altitude define a posição do driver de minifiltro em relação a outros minifiltros na pilha de E/S quando o minifiltro é carregado. A alocação de altitudes para minifiltros é gerenciada pela Microsoft. Para obter mais informações sobre altitudes, consulte grupos de pedidos de carga e altitudes para drivers de minifiltro.

Chame CmUnRegisterCallback para cancelar o registro de uma rotina de retorno de chamada que CmRegisterCallbackEx registrado.

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows Vista.
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

CmRegisterCallback

CmUnRegisterCallback

DRIVER_OBJECT

RegistryCallback

UNICODE_STRING

Compartilhar via