Função IoRegisterFileSystem (ntifs.h)

Artigo
02/26/2024

A rotina IoRegisterFileSystem adiciona um objeto de dispositivo de controle do sistema de arquivos à fila do sistema de arquivos global.

Sintaxe

void IoRegisterFileSystem(
  [in] __drv_aliasesMem PDEVICE_OBJECT DeviceObject
);

Parâmetros

[in] DeviceObject

Ponteiro para o objeto do dispositivo de controle para o sistema de arquivos.

Retornar valor

Nenhum

Comentários

IoRegisterFileSystem registra um sistema de arquivos como um sistema de arquivos ativo inserindo o objeto de dispositivo de controle do sistema de arquivos na fila do sistema de arquivos global e incrementa a contagem de referência no objeto do dispositivo de controle do sistema de arquivos.

O tipo de dispositivo do objeto do dispositivo de controle do sistema de arquivos deve ser um dos seguintes:

FILE_DEVICE_NETWORK_FILE_SYSTEM

FILE_DEVICE_CD_ROM_FILE_SYSTEM

FILE_DEVICE_DISK_FILE_SYSTEM

Se o tipo de dispositivo não for um desses valores, o sistema de arquivos não será registrado.

Além disso, o objeto do dispositivo de controle do sistema de arquivos deve ser nomeado. Se ele não for nomeado, isso não fará com que a chamada para IoRegisterFileSystem falhe. No entanto, os drivers de filtro do sistema de arquivos, bem como muitos componentes do sistema e rotinas de suporte, usam esse nome para distinguir os objetos de dispositivo de controle do sistema de arquivos, que são sempre nomeados, de seus objetos de dispositivo de volume, que nunca são nomeados.

Se o sinalizador DO_LOW_PRIORITY_FILESYSTEM estiver definido no objeto do dispositivo de controle do sistema de arquivos, o objeto do dispositivo será inserido na posição seguinte à última na fila. (O sistema de arquivos RAW ocupa a última posição na fila.) Se esse sinalizador não estiver definido, o objeto do dispositivo será inserido na cabeça da fila.

IoRegisterFileSystem chama as rotinas de notificação de drivers de filtro do sistema de arquivos que se registraram para essa notificação chamando IoRegisterFsRegistrationChange ou IoRegisterFsRegistrationChangeEx.

Nota No Microsoft Windows XP e posteriores, quando um driver de filtro do sistema de arquivos chama IoRegisterFsRegistrationChange, sua rotina de notificação também é chamada imediatamente para todos os sistemas de arquivos que já chamaram IoRegisterFileSystem.