Função FsRtlNotifyVolumeEvent (ntifs.h)

A rotina FsRtlNotifyVolumeEvent notifica todos os aplicativos registrados de que um evento de volume está ocorrendo.

Sintaxe

NTSTATUS FsRtlNotifyVolumeEvent(
  [in] PFILE_OBJECT FileObject,
  [in] ULONG        EventCode
);

Parâmetros

[in] FileObject

Um ponteiro para um objeto de arquivo para o volume fornecido.

[in] EventCode

Especifica um código de evento para o evento que está ocorrendo. Esse código pode ser um dos valores a seguir.

Código de evento GUID de evento PnP Significado
FSRTL_VOLUME_BACKGROUND_FORMAT GUID_IO_VOLUME_BACKGROUND_FORMAT Uma operação de formato de plano de fundo foi iniciada.
FSRTL_VOLUME_CHANGE_SIZE GUID_IO_VOLUME_CHANGE_SIZE O tamanho do sistema de arquivos no volume foi alterado. Para Windows Server 2003 e Windows XP/2000, não há suporte para esse valor.
FSRTL_VOLUME_DISMOUNT GUID_IO_VOLUME_DISMOUNT O volume está sendo desmontado.
FSRTL_VOLUME_DISMOUNT_FAILED GUID_IO_VOLUME_DISMOUNT_FAILED Falha na desmontagem do volume.
FSRTL_VOLUME_FORCED_CLOSED GUID_IO_VOLUME_FORCE_CLOSED O volume foi tornado somente leitura pelo sistema de arquivos. Esse sinalizador está disponível no Windows Vista e posterior.
FSRTL_VOLUME_INFO_MAKE_COMPAT GUID_IO_VOLUME_INFO_MAKE_COMPAT A mídia de volume foi removida, mas está em um estado incompatível e pode não ser legível por um dispositivo de armazenamento de mídia removível diferente. Esse sinalizador está disponível no Windows Vista e posterior.
FSRTL_VOLUME_LOCK GUID_IO_VOLUME_LOCK O volume está sendo bloqueado.
FSRTL_VOLUME_LOCK_FAILED GUID_IO_VOLUME_LOCK_FAILED Falha no bloqueio de volume.
FSRTL_VOLUME_MOUNT GUID_IO_VOLUME_MOUNT O volume está sendo montado.
FSRTL_VOLUME_NEEDS_CHKDSK GUID_IO_VOLUME_NEED_CHKDSK Dados corrompidos foram detectados no volume e precisam ser corrigidos executando o Chkdsk. Esse sinalizador está disponível no Windows Vista e posterior.
FSRTL_VOLUME_PREPARING_EJECT GUID_IO_VOLUME_PREPARING_EJECT O sistema de arquivos está preparando o disco para ser ejetado. Para Windows Server 2003 e Windows XP/2000, não há suporte para esse valor.
FSRTL_VOLUME_UNLOCK GUID_IO_VOLUME_UNLOCK O volume está sendo desbloqueado.
FSRTL_VOLUME_WEARING_OUT GUID_IO_VOLUME_WEARING_OUT A mídia de volume está se esgotando. Esse sinalizador está disponível no Windows Vista e posterior.
FSRTL_VOLUME_WORM_NEAR_FULL GUID_IO_VOLUME_WORM_NEAR_FULL O volume é um volume WORM (write-once, read-many) e está quase cheio. Esse sinalizador está disponível no Windows Vista e posterior.

Retornar valor

FsRtlNotifyVolumeEvent retorna o status da notificação.

Comentários

Os sistemas de arquivos chamam FsRtlNotifyVolumeEvent para notificar todos os aplicativos registrados no modo de usuário de que um evento de volume está ocorrendo.

Os valores de GUID de evento PnP são definidos em Ioevent.h.

Para se registrar para notificação de eventos de volume, os aplicativos devem chamar a função Microsoft Win32 RegisterDeviceNotification . Para obter mais informações, consulte a seção Gerenciamento de Dispositivos na documentação do SDK do Microsoft Windows.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Confira também

IoRegisterPlugPlayNotification

IoUnregisterPlugPlayNotification