Export (0) Print
Expand All
Expand Minimize

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

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

IRQL

<=DISPATCH_LEVEL

See also

FsRtlNotifyVolumeEvent
IoRegisterPlugPlayNotification
IoUnregisterPlugPlayNotification
TARGET_DEVICE_CUSTOM_NOTIFICATION

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft