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 |