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 seguintes valores.
| Código de evento | GUID de evento PnP | Significado |
|---|---|---|
| FSRTL_VOLUME_BACKGROUND_FORMAT | GUID_IO_VOLUME_BACKGROUND_FORMAT | Uma operação de formato em segundo plano 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, esse valor não tem suporte. |
| 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 feito 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 | Os 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, esse valor não tem suporte. |
| 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. |
Valor de retorno
FsRtlNotifyVolumeEvent retorna o status da notificação.
Observações
Os sistemas de arquivos chamam FsRtlNotifyVolumeEvent para notificar 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 evento de volume, os aplicativos devem chamar a função
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows XP |
| da Plataforma de Destino |
Universal |
| cabeçalho | ntifs.h (inclua Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL |
NtosKrnl.exe |
| IRQL | <= APC_LEVEL |