Função IoRegisterFsRegistrationChangeMountAware (ntifs.h)

Artigo
02/07/2025

A rotina de IoRegisterFsRegistrationChangeMountAware registra a rotina de notificação de um driver de filtro do sistema de arquivos. Essa rotina de notificação é chamada sempre que um sistema de arquivos registra ou cancela o registro como um sistema de arquivos ativo.

Sintaxe

NTSTATUS IoRegisterFsRegistrationChangeMountAware(
  [in] PDRIVER_OBJECT          DriverObject,
  [in] PDRIVER_FS_NOTIFICATION DriverNotificationRoutine,
  [in] BOOLEAN                 SynchronizeWithMounts
);

Parâmetros

[in] DriverObject

Um ponteiro para o objeto driver para o driver de filtro do sistema de arquivos.

[in] DriverNotificationRoutine

Um ponteiro para a rotina de PDRIVER_FS_NOTIFICATION, que o sistema de arquivos chama quando ele registra ou cancela o registro em si.

[in] SynchronizeWithMounts

Se definido como verdadeiro, essa rotina garante que nenhuma operação de montagem esteja em andamento ao fazer retornos de chamada de notificação. Se definido como FALSE, a rotina não tentará evitar conflitos com operações de montagem.

Valor de retorno

Retorna um dos seguintes valores NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	A rotina de notificação foi registrada com êxito.
STATUS_INSUFFICIENT_RESOURCES	Não foi possível alocar um pacote de notificação para a rotina de notificação.
STATUS_DEVICE_ALREADY_ATTACHED	Esse objeto de driver já foi registrado com esta notificação.

Observações

IoRegisterFsRegistrationChangeMountAware registra um driver de filtro do sistema de arquivos para ser notificado sempre que um sistema de arquivos chama IoRegisterFileSystem ou IoUnregisterFileSystem.

Para parar de receber essas notificações, o driver de filtro deve chamar IoUnregisterFsRegistrationChange.

Quando SynchronizeWithMounts é especificado como TRUE, IoRegisterFsRegistrationChangeMountAware aguarda a conclusão de quaisquer operações de montagem atuais e não permite que novas operações de montagem comecem até que IoRegisterFsRegistrationChangeMountAware seja concluída.

Observação Quando um driver de filtro do sistema de arquivos chama IoRegisterFsRegistrationChangeMountAware, sua rotina de notificação também é chamada imediatamente para todos os sistemas de arquivos registrados no momento, ou seja, sistemas de arquivos que já chamaram IoRegisterFileSystem, mas ainda não chamaram IoUnregisterFileSystem.

Como a rotina de notificação do chamador pode ser chamada antes mesmo de IoRegisterFsRegistrationChangeMountAware retorna, um driver de filtro não deve chamar essa rotina até que tenha criado estruturas de dados de que precisa processar essas notificações.

Além disso, IoRegisterFsRegistrationChangeMountAware ignora dispositivos RAW. Para obter informações sobre como anexar ao sistema de arquivos RAW pelo nome, consulte Anexando o objeto filter device ao objeto de dispositivo de destino.

IoRegisterFsRegistrationChangeMountAware incrementa a contagem de referência no objeto de driver do driver de filtro.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	A rotina IoRegisterFsRegistrationChangeMountAware é o Windows 7
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua FltKernel.h, Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL

Consulte também

IoRegisterFileSystem

IoRegisterFsRegistrationChange

IoRegisterFsRegistrationChangeEx

IoUnregisterFileSystem

IoUnregisterFsRegistrationChange

Compartilhar via