Función FsRtlNotifyVolumeEvent (ntifs.h)
La rutina FsRtlNotifyVolumeEvent 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 del 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 | El medio de volumen se ha quitado, pero está en un estado incompatible y es posible que un dispositivo de almacenamiento multimedia extraíble diferente 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 de 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 | Los medios de volumen se están destetiendo. 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.
Comentarios
Los sistemas de archivos llaman a FsRtlNotifyVolumeEvent para notificar a las aplicaciones en modo de usuario registradas que se está produciendo un evento de volumen.
Los valores guid del evento PnP se definen en Ioevent.h.
Para registrarse para la notificación de eventos de volumen, las aplicaciones deben llamar a la función RegisterDeviceNotification de Microsoft Win32. Para obtener más información, consulte la sección Administración de dispositivos de la documentación de Microsoft Windows SDK.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP |
| Plataforma de destino | Universal |
| Encabezado | ntifs.h (incluya Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |