The FsRtlNotifyVolumeEvent routine notifies any registered applications that a volume event is occurring.
- FileObject [in]
A pointer to a file object for the given volume.
- EventCode [in]
Specifies an event code for the event that is occurring. This code can be one of the following values.
Event Code PnP event GUID Meaning
A background format operation has been initiated.
The size of the file system on the volume has changed. For Windows Server 2003 and Windows XP/2000, this value is not supported.
The volume is being dismounted.
The volume dismount failed.
The volume has been made read-only by the file system. This flag is available on Windows Vista and later.
The volume media has been removed, but it is in an incompatible state and might not be readable by a different removable-media storage device. This flag is available on Windows Vista and later.
The volume is being locked.
The volume lock failed.
The volume is being mounted.
Data corruption was detected on the volume and it needs to be corrected by running Chkdsk. This flag is available on Windows Vista and later.
The file system is preparing the disc to be ejected. For Windows Server 2003 and Windows XP/2000, this value is not supported.
The volume is being unlocked.
The volume media is wearing out. This flag is available on Windows Vista and later.
The volume is a write-once, read-many (WORM) volume and it is nearly full. This flag is available on Windows Vista and later.
FsRtlNotifyVolumeEvent returns the status of the notification.
File systems call FsRtlNotifyVolumeEvent to notify any registered user-mode applications that a volume event is occurring.
PnP event GUID values are defined in Ioevent.h.
To register for volume event notification, applications must call the Microsoft Win32 RegisterDeviceNotification function. For more information, see the Device Management section in the Microsoft Windows SDK documentation.
|This routine is available on Microsoft Windows XP and later.|