FsRtlNotifyVolumeEventEx routine

The FsRtlNotifyVolumeEventEx routine notifies any registered applications that a volume event is occurring. Volume events include the volume being locked, unlocked, mounted, or made read-only.

Syntax


NTSTATUS FsRtlNotifyVolumeEventEx(
  _In_ PFILE_OBJECT                       FileObject,
  _In_ ULONG                              EventCode,
  _In_ PTARGET_DEVICE_CUSTOM_NOTIFICATION Event
);

Parameters

FileObject [in]

A pointer to a FILE_OBJECT that specifies a volume.

EventCode [in]

An event code for the event that is occurring. For a table of event codes, see FsRtlNotifyVolumeEvent.

Event [in]

A pointer to the initialized custom notification structure (TARGET_DEVICE_CUSTOM_NOTIFICATION) to use.

Return value

Returns STATUS_SUCCESS on success or another relevant NTSTATUS value, such as STATUS_INVALID_PARAMETER, if the EventCode is not valid.

Remarks

Note   When you specify the Event parameter as a custom volume notification, set the following members of the TARGET_DEVICE_CUSTOM_NOTIFICATION object as follows:

Version to 1.

FileObject to NULL.

 

Requirements

Target platform

Universal

Version

Available in Windows Vista and later version of the Windows operating system.

Header

Ntifs.h (include FltKernel.h or Ntifs.h)

Library

NtosKrnl.lib

DLL

NtosKrnl.exe

IRQL

<=DISPATCH_LEVEL

See also

FsRtlNotifyVolumeEvent
IoRegisterPlugPlayNotification
IoUnregisterPlugPlayNotification
TARGET_DEVICE_CUSTOM_NOTIFICATION

 

 

Send comments about this topic to Microsoft

Show: