Función FsRtlNotifyVolumeEvent (ntifs.h)

  • Artículo

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

Consulte también

IoRegisterPlugPlayNotification

IoUnregisterPlugPlayNotification