Función FsRtlNotifyVolumeEvent (ntifs.h)
El FsRtlNotifyVolumeEvent rutina notifica a las aplicaciones registradas que se está produciendo un evento de volumen.
Sintaxis
NTSTATUS FsRtlNotifyVolumeEvent(
[in] PFILE_OBJECT FileObject,
[in] ULONG EventCode
);
Parámetros
[in] FileObject
Puntero a un objeto de archivo para el volumen especificado.
[in] EventCode
Especifica un código de evento para el evento que se está produciendo. Este código puede ser uno de los siguientes valores.
| Código de evento | GUID de evento PnP | Significado |
|---|---|---|
| FSRTL_VOLUME_BACKGROUND_FORMAT | GUID_IO_VOLUME_BACKGROUND_FORMAT | Se ha iniciado una operación de formato en segundo plano. |
| FSRTL_VOLUME_CHANGE_SIZE | GUID_IO_VOLUME_CHANGE_SIZE | El tamaño del sistema de archivos del volumen ha cambiado. Para Windows Server 2003 y Windows XP/2000, este valor no se admite. |
| FSRTL_VOLUME_DISMOUNT | GUID_IO_VOLUME_DISMOUNT | El volumen se está desmontando. |
| FSRTL_VOLUME_DISMOUNT_FAILED | GUID_IO_VOLUME_DISMOUNT_FAILED | Error en el desmontaje del volumen. |
| FSRTL_VOLUME_FORCED_CLOSED | GUID_IO_VOLUME_FORCE_CLOSED | El sistema de archivos ha hecho que el volumen sea de solo lectura. Esta marca está disponible en Windows Vista y versiones posteriores. |
| FSRTL_VOLUME_INFO_MAKE_COMPAT | GUID_IO_VOLUME_INFO_MAKE_COMPAT | Se ha quitado el medio de volumen, pero está en un estado incompatible y es posible que un dispositivo de almacenamiento de medios extraíbles no pueda leerlo. Esta marca está disponible en Windows Vista y versiones posteriores. |
| FSRTL_VOLUME_LOCK | GUID_IO_VOLUME_LOCK | El volumen se está bloqueando. |
| FSRTL_VOLUME_LOCK_FAILED | GUID_IO_VOLUME_LOCK_FAILED | Error en el bloqueo del volumen. |
| FSRTL_VOLUME_MOUNT | GUID_IO_VOLUME_MOUNT | El volumen se está montando. |
| FSRTL_VOLUME_NEEDS_CHKDSK | GUID_IO_VOLUME_NEED_CHKDSK | Los datos dañados se detectaron en el volumen y deben corregirse mediante la ejecución de Chkdsk. Esta marca está disponible en Windows Vista y versiones posteriores. |
| FSRTL_VOLUME_PREPARING_EJECT | GUID_IO_VOLUME_PREPARING_EJECT | El sistema de archivos está preparando el disco que se va a expulsar. Para Windows Server 2003 y Windows XP/2000, este valor no se admite. |
| FSRTL_VOLUME_UNLOCK | GUID_IO_VOLUME_UNLOCK | El volumen se está desbloqueando. |
| FSRTL_VOLUME_WEARING_OUT | GUID_IO_VOLUME_WEARING_OUT | El medio de volumen se está usando. Esta marca está disponible en Windows Vista y versiones posteriores. |
| FSRTL_VOLUME_WORM_NEAR_FULL | GUID_IO_VOLUME_WORM_NEAR_FULL | El volumen es un volumen de escritura una vez, de varios (WORM) y está casi lleno. Esta marca está disponible en Windows Vista y versiones posteriores. |
Valor devuelto
FsRtlNotifyVolumeEvent devuelve el estado de la notificación.
Observaciones
Los sistemas de archivos llaman a FsRtlNotifyVolumeEvent para notificar a las aplicaciones registradas en modo de usuario que se está produciendo un evento de volumen.
Los valores GUID del evento PnP se definen en Ioevent.h.
Para registrar la notificación de eventos de volumen, las aplicaciones deben llamar a la función RegisterDeviceNotification de Microsoft Win32
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows XP |
| de la plataforma de destino de |
Universal |
| encabezado de |
ntifs.h (incluya Ntifs.h) |
| biblioteca de |
NtosKrnl.lib |
| DLL de |
NtosKrnl.exe |
| irQL | <= APC_LEVEL |