pnp.c File Reference

#include "FsRtlP.h"
#include <IoEvent.h>

Go to the source code of this file.

Functions
NTKERNELAPI NTSTATUS	FsRtlNotifyVolumeEvent (IN PFILE_OBJECT FileObject, IN ULONG EventCode)

---

Function Documentation

NTKERNELAPI NTSTATUS FsRtlNotifyVolumeEvent (  IN PFILE_OBJECT  FileObject, IN ULONG  EventCode )

Definition at line 41 of file fsrtl/pnp.c. References ASSERT, Event(), FSRTL_VOLUME_DISMOUNT, FSRTL_VOLUME_DISMOUNT_FAILED, FSRTL_VOLUME_LOCK, FSRTL_VOLUME_LOCK_FAILED, FSRTL_VOLUME_MOUNT, FSRTL_VOLUME_UNLOCK, IoGetRelatedTargetDevice(), IoReportTargetDeviceChange(), IoReportTargetDeviceChangeAsynchronous(), NT_SUCCESS, NTSTATUS(), NULL, ObDereferenceObject, Status, TARGET_DEVICE_CUSTOM_NOTIFICATION, and USHORT. Referenced by UdfCommonCleanup(), UdfDismountVolume(), UdfLockVolume(), UdfMountVolume(), UdfUnlockVolume(), and UdfVerifyVolume(). : This routine notifies any registered applications that a volume is being locked, unlocked, etc. Arguments: FileeObject - Supplies a file object for the volume being locked. EventCode - Which event is occuring -- e.g. FSRTL_VOLUME_LOCK Return Value: Status of the notification. --*/ { NTSTATUS Status = STATUS_SUCCESS; TARGET_DEVICE_CUSTOM_NOTIFICATION Event; PDEVICE_OBJECT Pdo; // // Retrieve the device object associated with this file object. // Status = IoGetRelatedTargetDevice( FileObject, &Pdo ); if (NT_SUCCESS( Status )) { ASSERT(Pdo != NULL); Event.Version = 1; Event.FileObject = NULL; Event.NameBufferOffset = -1; Event.Size = (USHORT)FIELD_OFFSET( TARGET_DEVICE_CUSTOM_NOTIFICATION, CustomDataBuffer ); switch (EventCode) { case FSRTL_VOLUME_DISMOUNT: RtlCopyMemory( &Event.Event, &GUID_IO_VOLUME_DISMOUNT, sizeof( GUID )); break; case FSRTL_VOLUME_DISMOUNT_FAILED: RtlCopyMemory( &Event.Event, &GUID_IO_VOLUME_DISMOUNT_FAILED, sizeof( GUID )); break; case FSRTL_VOLUME_LOCK: RtlCopyMemory( &Event.Event, &GUID_IO_VOLUME_LOCK, sizeof( GUID )); break; case FSRTL_VOLUME_LOCK_FAILED: RtlCopyMemory( &Event.Event, &GUID_IO_VOLUME_LOCK_FAILED, sizeof( GUID )); break; case FSRTL_VOLUME_MOUNT: // // Mount notification is asynchronous to avoid deadlocks when someone // unwittingly causes a mount in the course of handling some other // PnP notification, e.g. MountMgr's device arrival code. // RtlCopyMemory( &Event.Event, &GUID_IO_VOLUME_MOUNT, sizeof( GUID )); IoReportTargetDeviceChangeAsynchronous( Pdo, &Event, NULL, NULL ); ObDereferenceObject( Pdo ); return STATUS_SUCCESS; break; case FSRTL_VOLUME_UNLOCK: RtlCopyMemory( &Event.Event, &GUID_IO_VOLUME_UNLOCK, sizeof( GUID )); break; default: ObDereferenceObject( Pdo ); return STATUS_INVALID_PARAMETER; } IoReportTargetDeviceChange( Pdo, &Event ); ObDereferenceObject( Pdo ); } return Status; }

---