Função IoRegisterFsRegistrationChangeMountAware (ntifs.h)

Artigo
03/08/2023

A rotina 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 de driver para o driver de filtro do sistema de arquivos.

[in] DriverNotificationRoutine

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

[in] SynchronizeWithMounts

Se definida como TRUE, 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.

Retornar valor

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 essa notificação.

Comentários

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 todas as operações de montagem atuais e não permite que novas operações de montagem comecem até que IoRegisterFsRegistrationChangeMountAware seja concluído.

Nota 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 retornar, um driver de filtro não deve chamar essa rotina até que tenha criado estruturas de dados de que precisa para 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 de dispositivo de filtro ao objeto de dispositivo de destino.

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

Requisitos

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