Função IoRegisterFsRegistrationChangeEx (ntifs.h)

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

Sintaxe

NTSTATUS IoRegisterFsRegistrationChangeEx(
  [in] PDRIVER_OBJECT          DriverObject,
  [in] PDRIVER_FS_NOTIFICATION DriverNotificationRoutine
);

Parâmetros

[in] DriverObject

Ponteiro para o objeto de driver do 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.

Retornar valor

IoRegisterFsRegistrationChangeEx retorna um dos seguintes valores:

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.

Comentários

O efeito de IoRegisterFsRegistrationChangeEx é idêntico ao de IoRegisterFsRegistrationChange no Windows XP e posterior.

IoRegisterFsRegistrationChangeEx 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 um driver de filtro do sistema de arquivos chama IoRegisterFsRegistrationChangeEx, 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 IoRegisterFsRegistrationChangeEx retornar, um driver de filtro não deve chamar essa rotina até que tenha criado estruturas de dados necessárias para processar essas notificações.

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

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

Se um driver de filtro do sistema de arquivos chamar IoRegisterFsRegistrationChangeEx duas vezes seguidas (sem chamar IoUnregisterFsRegistrationChange entre), passando os mesmos valores para os parâmetros DriverObject e DriverNotificationRoutine registrados na chamada anterior para IoRegisterFsRegistrationChangeEx, e nenhum outro driver de filtro foi registrado desde a primeira chamada, IoRegisterFsRegistrationChangeEx retorna STATUS_DEVICE_ALREADY_ATTACHED.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Essa rotina só está disponível no pacote cumulativo de atualizações para o sistema operacional Windows 2000 Service Pack 4 (SP4).
Plataforma de Destino	Área de Trabalho
Cabeçalho	ntifs.h (inclua Ntifs.h)
IRQL	<= APC_LEVEL

Confira também

IoRegisterFileSystem

IoRegisterFsRegistrationChange

IoUnregisterFileSystem

IoUnregisterFsRegistrationChange