mirror of
https://github.com/reactos/reactos.git
synced 2024-08-26 13:18:51 +00:00
![Pierre Schweitzer](/assets/img/avatar_default.png)
This implies that a sample for W10. It has been backported to NT5.2; not sure how it would work on a W2K3 (feel free to test!)
903 lines
21 KiB
C
903 lines
21 KiB
C
/*++
|
||
|
||
Copyright (c) 1997-2000 Microsoft Corporation
|
||
|
||
Module Name:
|
||
|
||
Pnp.c
|
||
|
||
Abstract:
|
||
|
||
This module implements the Plug and Play routines for FAT called by
|
||
the dispatch driver.
|
||
|
||
|
||
--*/
|
||
|
||
#include "fatprocs.h"
|
||
|
||
//
|
||
// The Bug check file id for this module
|
||
//
|
||
|
||
#define BugCheckFileId (FAT_BUG_CHECK_PNP)
|
||
|
||
#define Dbg (DEBUG_TRACE_PNP)
|
||
|
||
_Requires_lock_held_(_Global_critical_region_)
|
||
_Requires_lock_held_(FatData.Resource)
|
||
NTSTATUS
|
||
FatPnpQueryRemove (
|
||
PIRP_CONTEXT IrpContext,
|
||
PIRP Irp,
|
||
PVCB Vcb
|
||
);
|
||
|
||
_Requires_lock_held_(_Global_critical_region_)
|
||
NTSTATUS
|
||
FatPnpRemove (
|
||
PIRP_CONTEXT IrpContext,
|
||
PIRP Irp,
|
||
PVCB Vcb
|
||
);
|
||
|
||
_Requires_lock_held_(_Global_critical_region_)
|
||
NTSTATUS
|
||
FatPnpSurpriseRemove (
|
||
PIRP_CONTEXT IrpContext,
|
||
PIRP Irp,
|
||
PVCB Vcb
|
||
);
|
||
|
||
_Requires_lock_held_(_Global_critical_region_)
|
||
NTSTATUS
|
||
FatPnpCancelRemove (
|
||
PIRP_CONTEXT IrpContext,
|
||
PIRP Irp,
|
||
PVCB Vcb
|
||
);
|
||
|
||
IO_COMPLETION_ROUTINE FatPnpCompletionRoutine;
|
||
|
||
NTSTATUS
|
||
NTAPI
|
||
FatPnpCompletionRoutine (
|
||
_In_ PDEVICE_OBJECT DeviceObject,
|
||
_In_ PIRP Irp,
|
||
_In_reads_opt_(_Inexpressible_("varies")) PVOID Contxt
|
||
);
|
||
|
||
#ifdef ALLOC_PRAGMA
|
||
#pragma alloc_text(PAGE, FatCommonPnp)
|
||
#pragma alloc_text(PAGE, FatFsdPnp)
|
||
#pragma alloc_text(PAGE, FatPnpCancelRemove)
|
||
#pragma alloc_text(PAGE, FatPnpQueryRemove)
|
||
#pragma alloc_text(PAGE, FatPnpRemove)
|
||
#pragma alloc_text(PAGE, FatPnpSurpriseRemove)
|
||
#endif
|
||
|
||
|
||
_Function_class_(IRP_MJ_PNP)
|
||
_Function_class_(DRIVER_DISPATCH)
|
||
NTSTATUS
|
||
NTAPI
|
||
FatFsdPnp (
|
||
_In_ PVOLUME_DEVICE_OBJECT VolumeDeviceObject,
|
||
_Inout_ PIRP Irp
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
This routine implements the FSD part of PnP operations
|
||
|
||
Arguments:
|
||
|
||
VolumeDeviceObject - Supplies the volume device object where the
|
||
file exists
|
||
|
||
Irp - Supplies the Irp being processed
|
||
|
||
Return Value:
|
||
|
||
NTSTATUS - The FSD status for the IRP
|
||
|
||
--*/
|
||
|
||
{
|
||
NTSTATUS Status;
|
||
PIRP_CONTEXT IrpContext = NULL;
|
||
|
||
BOOLEAN TopLevel;
|
||
BOOLEAN Wait;
|
||
|
||
PAGED_CODE();
|
||
|
||
DebugTrace(+1, Dbg, "FatFsdPnp\n", 0);
|
||
|
||
FsRtlEnterFileSystem();
|
||
|
||
TopLevel = FatIsIrpTopLevel( Irp );
|
||
|
||
_SEH2_TRY {
|
||
|
||
//
|
||
// We expect there to never be a fileobject, in which case we will always
|
||
// wait. Since at the moment we don't have any concept of pending Pnp
|
||
// operations, this is a bit nitpicky.
|
||
//
|
||
|
||
if (IoGetCurrentIrpStackLocation( Irp )->FileObject == NULL) {
|
||
|
||
Wait = TRUE;
|
||
|
||
} else {
|
||
|
||
Wait = CanFsdWait( Irp );
|
||
}
|
||
|
||
IrpContext = FatCreateIrpContext( Irp, Wait );
|
||
|
||
Status = FatCommonPnp( IrpContext, Irp );
|
||
|
||
} _SEH2_EXCEPT(FatExceptionFilter( IrpContext, _SEH2_GetExceptionInformation() )) {
|
||
|
||
//
|
||
// We had some trouble trying to perform the requested
|
||
// operation, so we'll abort the I/O request with
|
||
// the error status that we get back from the
|
||
// execption code
|
||
//
|
||
|
||
Status = FatProcessException( IrpContext, Irp, _SEH2_GetExceptionCode() );
|
||
} _SEH2_END;
|
||
|
||
if (TopLevel) { IoSetTopLevelIrp( NULL ); }
|
||
|
||
FsRtlExitFileSystem();
|
||
|
||
//
|
||
// And return to our caller
|
||
//
|
||
|
||
DebugTrace(-1, Dbg, "FatFsdPnp -> %08lx\n", Status);
|
||
|
||
UNREFERENCED_PARAMETER( VolumeDeviceObject );
|
||
|
||
return Status;
|
||
}
|
||
|
||
|
||
_Requires_lock_held_(_Global_critical_region_)
|
||
NTSTATUS
|
||
FatCommonPnp (
|
||
IN PIRP_CONTEXT IrpContext,
|
||
IN PIRP Irp
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
This is the common routine for doing PnP operations called
|
||
by both the fsd and fsp threads
|
||
|
||
Arguments:
|
||
|
||
Irp - Supplies the Irp to process
|
||
|
||
Return Value:
|
||
|
||
NTSTATUS - The return status for the operation
|
||
|
||
--*/
|
||
|
||
{
|
||
NTSTATUS Status;
|
||
|
||
PIO_STACK_LOCATION IrpSp;
|
||
|
||
PVOLUME_DEVICE_OBJECT OurDeviceObject;
|
||
PVCB Vcb;
|
||
|
||
PAGED_CODE();
|
||
|
||
//
|
||
// Force everything to wait.
|
||
//
|
||
|
||
SetFlag( IrpContext->Flags, IRP_CONTEXT_FLAG_WAIT);
|
||
|
||
//
|
||
// Get the current Irp stack location.
|
||
//
|
||
|
||
IrpSp = IoGetCurrentIrpStackLocation( Irp );
|
||
|
||
//
|
||
// Find our Vcb. This is tricky since we have no file object in the Irp.
|
||
//
|
||
|
||
OurDeviceObject = (PVOLUME_DEVICE_OBJECT) IrpSp->DeviceObject;
|
||
|
||
//
|
||
// Take the global lock to synchronise against volume teardown.
|
||
//
|
||
|
||
#ifdef _MSC_VER
|
||
#pragma prefast( push )
|
||
#pragma prefast( disable: 28137, "prefast wants the wait to be a constant, but that isn't possible for the way fastfat is designed" )
|
||
#pragma prefast( disable: 28193, "this will always wait" )
|
||
#endif
|
||
|
||
FatAcquireExclusiveGlobal( IrpContext );
|
||
|
||
#ifdef _MSC_VER
|
||
#pragma prefast( pop )
|
||
#endif
|
||
|
||
//
|
||
// Make sure this device object really is big enough to be a volume device
|
||
// object. If it isn't, we need to get out before we try to reference some
|
||
// field that takes us past the end of an ordinary device object.
|
||
//
|
||
|
||
#ifdef _MSC_VER
|
||
#pragma prefast( suppress: 28175, "touching Size is ok for a filesystem" )
|
||
#endif
|
||
if (OurDeviceObject->DeviceObject.Size != sizeof(VOLUME_DEVICE_OBJECT) ||
|
||
NodeType( &OurDeviceObject->Vcb ) != FAT_NTC_VCB) {
|
||
|
||
//
|
||
// We were called with something we don't understand.
|
||
//
|
||
|
||
FatReleaseGlobal( IrpContext );
|
||
|
||
Status = STATUS_INVALID_PARAMETER;
|
||
FatCompleteRequest( IrpContext, Irp, Status );
|
||
return Status;
|
||
}
|
||
|
||
Vcb = &OurDeviceObject->Vcb;
|
||
|
||
//
|
||
// Case on the minor code.
|
||
//
|
||
|
||
switch ( IrpSp->MinorFunction ) {
|
||
|
||
case IRP_MN_QUERY_REMOVE_DEVICE:
|
||
|
||
Status = FatPnpQueryRemove( IrpContext, Irp, Vcb );
|
||
break;
|
||
|
||
case IRP_MN_SURPRISE_REMOVAL:
|
||
|
||
Status = FatPnpSurpriseRemove( IrpContext, Irp, Vcb );
|
||
break;
|
||
|
||
case IRP_MN_REMOVE_DEVICE:
|
||
|
||
Status = FatPnpRemove( IrpContext, Irp, Vcb );
|
||
break;
|
||
|
||
case IRP_MN_CANCEL_REMOVE_DEVICE:
|
||
|
||
Status = FatPnpCancelRemove( IrpContext, Irp, Vcb );
|
||
break;
|
||
|
||
default:
|
||
|
||
FatReleaseGlobal( IrpContext );
|
||
|
||
//
|
||
// Just pass the IRP on. As we do not need to be in the
|
||
// way on return, ellide ourselves out of the stack.
|
||
//
|
||
|
||
IoSkipCurrentIrpStackLocation( Irp );
|
||
|
||
Status = IoCallDriver(Vcb->TargetDeviceObject, Irp);
|
||
|
||
//
|
||
// Cleanup our Irp Context. The driver has completed the Irp.
|
||
//
|
||
|
||
FatCompleteRequest( IrpContext, NULL, STATUS_SUCCESS );
|
||
|
||
break;
|
||
}
|
||
|
||
return Status;
|
||
}
|
||
|
||
|
||
VOID
|
||
FatPnpAdjustVpbRefCount(
|
||
IN PVCB Vcb,
|
||
IN ULONG Delta
|
||
)
|
||
{
|
||
KIRQL OldIrql;
|
||
|
||
IoAcquireVpbSpinLock( &OldIrql);
|
||
Vcb->Vpb->ReferenceCount += Delta;
|
||
IoReleaseVpbSpinLock( OldIrql);
|
||
}
|
||
|
||
_Requires_lock_held_(_Global_critical_region_)
|
||
_Requires_lock_held_(FatData.Resource)
|
||
NTSTATUS
|
||
FatPnpQueryRemove (
|
||
PIRP_CONTEXT IrpContext,
|
||
PIRP Irp,
|
||
PVCB Vcb
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
This routine handles the PnP query remove operation. The filesystem
|
||
is responsible for answering whether there are any reasons it sees
|
||
that the volume can not go away (and the device removed). Initiation
|
||
of the dismount begins when we answer yes to this question.
|
||
|
||
Query will be followed by a Cancel or Remove.
|
||
|
||
Arguments:
|
||
|
||
Irp - Supplies the Irp to process
|
||
|
||
Vcb - Supplies the volume being queried.
|
||
|
||
Return Value:
|
||
|
||
NTSTATUS - The return status for the operation
|
||
|
||
--*/
|
||
|
||
{
|
||
NTSTATUS Status = STATUS_SUCCESS;
|
||
KEVENT Event;
|
||
BOOLEAN VcbDeleted = FALSE;
|
||
BOOLEAN GlobalHeld = TRUE;
|
||
|
||
PAGED_CODE();
|
||
|
||
//
|
||
// Having said yes to a QUERY, any communication with the
|
||
// underlying storage stack is undefined (and may block)
|
||
// until the bounding CANCEL or REMOVE is sent.
|
||
//
|
||
|
||
FatAcquireExclusiveVcb( IrpContext, Vcb );
|
||
|
||
FatReleaseGlobal( IrpContext);
|
||
GlobalHeld = FALSE;
|
||
|
||
_SEH2_TRY {
|
||
|
||
Status = FatLockVolumeInternal( IrpContext, Vcb, NULL );
|
||
|
||
//
|
||
// Drop an additional reference on the Vpb so that the volume cannot be
|
||
// torn down when we drop all the locks below.
|
||
//
|
||
|
||
FatPnpAdjustVpbRefCount( Vcb, 1);
|
||
|
||
//
|
||
// Drop and reacquire the resources in the right order.
|
||
//
|
||
|
||
FatReleaseVcb( IrpContext, Vcb );
|
||
|
||
NT_ASSERT( FlagOn(IrpContext->Flags, IRP_CONTEXT_FLAG_WAIT) );
|
||
|
||
#ifdef _MSC_VER
|
||
#pragma prefast( push )
|
||
#pragma prefast( disable: 28137, "prefast wants the wait to be a constant, but that isn't possible for the way fastfat is designed" )
|
||
#pragma prefast( disable: 28193, "this will always wait" )
|
||
#endif
|
||
|
||
FatAcquireExclusiveGlobal( IrpContext );
|
||
GlobalHeld = TRUE;
|
||
|
||
#ifdef _MSC_VER
|
||
#pragma prefast( pop )
|
||
#endif
|
||
|
||
FatAcquireExclusiveVcb( IrpContext, Vcb );
|
||
|
||
//
|
||
// Drop the reference we added above.
|
||
//
|
||
|
||
FatPnpAdjustVpbRefCount( Vcb, (ULONG)-1);
|
||
|
||
if (NT_SUCCESS( Status )) {
|
||
|
||
//
|
||
// With the volume held locked, note that we must finalize as much
|
||
// as possible right now.
|
||
//
|
||
|
||
FatFlushAndCleanVolume( IrpContext, Irp, Vcb, Flush );
|
||
|
||
//
|
||
// We need to pass this down before starting the dismount, which
|
||
// could disconnect us immediately from the stack.
|
||
//
|
||
|
||
//
|
||
// Get the next stack location, and copy over the stack location
|
||
//
|
||
|
||
IoCopyCurrentIrpStackLocationToNext( Irp );
|
||
|
||
//
|
||
// Set up the completion routine
|
||
//
|
||
|
||
KeInitializeEvent( &Event, NotificationEvent, FALSE );
|
||
IoSetCompletionRoutine( Irp,
|
||
FatPnpCompletionRoutine,
|
||
&Event,
|
||
TRUE,
|
||
TRUE,
|
||
TRUE );
|
||
|
||
//
|
||
// Send the request and wait.
|
||
//
|
||
|
||
Status = IoCallDriver(Vcb->TargetDeviceObject, Irp);
|
||
|
||
if (Status == STATUS_PENDING) {
|
||
|
||
KeWaitForSingleObject( &Event,
|
||
Executive,
|
||
KernelMode,
|
||
FALSE,
|
||
NULL );
|
||
|
||
Status = Irp->IoStatus.Status;
|
||
}
|
||
|
||
//
|
||
// Now if no one below us failed already, initiate the dismount
|
||
// on this volume, make it go away. PnP needs to see our internal
|
||
// streams close and drop their references to the target device.
|
||
//
|
||
// Since we were able to lock the volume, we are guaranteed to
|
||
// move this volume into dismount state and disconnect it from
|
||
// the underlying storage stack. The force on our part is actually
|
||
// unnecesary, though complete.
|
||
//
|
||
// What is not strictly guaranteed, though, is that the closes
|
||
// for the metadata streams take effect synchronously underneath
|
||
// of this call. This would leave references on the target device
|
||
// even though we are disconnected!
|
||
//
|
||
|
||
if (NT_SUCCESS( Status )) {
|
||
|
||
VcbDeleted = FatCheckForDismount( IrpContext, Vcb, TRUE );
|
||
|
||
NT_ASSERT( VcbDeleted || Vcb->VcbCondition == VcbBad );
|
||
|
||
}
|
||
}
|
||
|
||
} _SEH2_FINALLY {
|
||
|
||
//
|
||
// Release the Vcb if it could still remain.
|
||
//
|
||
|
||
if (!VcbDeleted) {
|
||
|
||
FatReleaseVcb( IrpContext, Vcb );
|
||
}
|
||
|
||
if (GlobalHeld) {
|
||
|
||
FatReleaseGlobal( IrpContext );
|
||
}
|
||
} _SEH2_END;
|
||
|
||
//
|
||
// Cleanup our IrpContext and complete the IRP if neccesary.
|
||
//
|
||
|
||
FatCompleteRequest( IrpContext, Irp, Status );
|
||
|
||
return Status;
|
||
}
|
||
|
||
|
||
|
||
_Requires_lock_held_(_Global_critical_region_)
|
||
NTSTATUS
|
||
FatPnpRemove (
|
||
PIRP_CONTEXT IrpContext,
|
||
PIRP Irp,
|
||
PVCB Vcb
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
This routine handles the PnP remove operation. This is our notification
|
||
that the underlying storage device for the volume we have is gone, and
|
||
an excellent indication that the volume will never reappear. The filesystem
|
||
is responsible for initiation or completion of the dismount.
|
||
|
||
Arguments:
|
||
|
||
Irp - Supplies the Irp to process
|
||
|
||
Vcb - Supplies the volume being removed.
|
||
|
||
Return Value:
|
||
|
||
NTSTATUS - The return status for the operation
|
||
|
||
--*/
|
||
|
||
{
|
||
NTSTATUS Status;
|
||
KEVENT Event;
|
||
BOOLEAN VcbDeleted = FALSE;
|
||
|
||
PAGED_CODE();
|
||
|
||
//
|
||
// REMOVE - a storage device is now gone. We either got
|
||
// QUERY'd and said yes OR got a SURPRISE OR a storage
|
||
// stack failed to spin back up from a sleep/stop state
|
||
// (the only case in which this will be the first warning).
|
||
//
|
||
// Note that it is entirely unlikely that we will be around
|
||
// for a REMOVE in the first two cases, as we try to intiate
|
||
// dismount.
|
||
//
|
||
|
||
//
|
||
// Acquire the global resource so that we can try to vaporize
|
||
// the volume, and the vcb resource itself.
|
||
//
|
||
|
||
FatAcquireExclusiveVcb( IrpContext, Vcb );
|
||
|
||
//
|
||
// The device will be going away. Remove our lock (benign
|
||
// if we never had it).
|
||
//
|
||
|
||
(VOID) FatUnlockVolumeInternal( IrpContext, Vcb, NULL );
|
||
|
||
//
|
||
// We need to pass this down before starting the dismount, which
|
||
// could disconnect us immediately from the stack.
|
||
//
|
||
|
||
//
|
||
// Get the next stack location, and copy over the stack location
|
||
//
|
||
|
||
IoCopyCurrentIrpStackLocationToNext( Irp );
|
||
|
||
//
|
||
// Set up the completion routine
|
||
//
|
||
|
||
KeInitializeEvent( &Event, NotificationEvent, FALSE );
|
||
IoSetCompletionRoutine( Irp,
|
||
FatPnpCompletionRoutine,
|
||
&Event,
|
||
TRUE,
|
||
TRUE,
|
||
TRUE );
|
||
|
||
//
|
||
// Send the request and wait.
|
||
//
|
||
|
||
Status = IoCallDriver(Vcb->TargetDeviceObject, Irp);
|
||
|
||
if (Status == STATUS_PENDING) {
|
||
|
||
KeWaitForSingleObject( &Event,
|
||
Executive,
|
||
KernelMode,
|
||
FALSE,
|
||
NULL );
|
||
|
||
Status = Irp->IoStatus.Status;
|
||
}
|
||
|
||
_SEH2_TRY {
|
||
|
||
//
|
||
// Knock as many files down for this volume as we can.
|
||
//
|
||
|
||
FatFlushAndCleanVolume( IrpContext, Irp, Vcb, NoFlush );
|
||
|
||
//
|
||
// Now make our dismount happen. This may not vaporize the
|
||
// Vcb, of course, since there could be any number of handles
|
||
// outstanding if we were not preceeded by a QUERY.
|
||
//
|
||
// PnP will take care of disconnecting this stack if we
|
||
// couldn't get off of it immediately.
|
||
//
|
||
|
||
VcbDeleted = FatCheckForDismount( IrpContext, Vcb, TRUE );
|
||
|
||
} _SEH2_FINALLY {
|
||
|
||
//
|
||
// Release the Vcb if it could still remain.
|
||
//
|
||
|
||
if (!VcbDeleted) {
|
||
|
||
FatReleaseVcb( IrpContext, Vcb );
|
||
}
|
||
|
||
FatReleaseGlobal( IrpContext );
|
||
} _SEH2_END;
|
||
|
||
//
|
||
// Cleanup our IrpContext and complete the IRP.
|
||
//
|
||
|
||
FatCompleteRequest( IrpContext, Irp, Status );
|
||
|
||
return Status;
|
||
}
|
||
|
||
|
||
_Requires_lock_held_(_Global_critical_region_)
|
||
NTSTATUS
|
||
FatPnpSurpriseRemove (
|
||
PIRP_CONTEXT IrpContext,
|
||
PIRP Irp,
|
||
PVCB Vcb
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
This routine handles the PnP surprise remove operation. This is another
|
||
type of notification that the underlying storage device for the volume we
|
||
have is gone, and is excellent indication that the volume will never reappear.
|
||
The filesystem is responsible for initiation or completion the dismount.
|
||
|
||
For the most part, only "real" drivers care about the distinction of a
|
||
surprise remove, which is a result of our noticing that a user (usually)
|
||
physically reached into the machine and pulled something out.
|
||
|
||
Surprise will be followed by a Remove when all references have been shut down.
|
||
|
||
Arguments:
|
||
|
||
Irp - Supplies the Irp to process
|
||
|
||
Vcb - Supplies the volume being removed.
|
||
|
||
Return Value:
|
||
|
||
NTSTATUS - The return status for the operation
|
||
|
||
--*/
|
||
|
||
{
|
||
NTSTATUS Status;
|
||
KEVENT Event;
|
||
BOOLEAN VcbDeleted = FALSE;
|
||
|
||
PAGED_CODE();
|
||
|
||
//
|
||
// SURPRISE - a device was physically yanked away without
|
||
// any warning. This means external forces.
|
||
//
|
||
|
||
FatAcquireExclusiveVcb( IrpContext, Vcb );
|
||
|
||
//
|
||
// We need to pass this down before starting the dismount, which
|
||
// could disconnect us immediately from the stack.
|
||
//
|
||
|
||
//
|
||
// Get the next stack location, and copy over the stack location
|
||
//
|
||
|
||
IoCopyCurrentIrpStackLocationToNext( Irp );
|
||
|
||
//
|
||
// Set up the completion routine
|
||
//
|
||
|
||
KeInitializeEvent( &Event, NotificationEvent, FALSE );
|
||
IoSetCompletionRoutine( Irp,
|
||
FatPnpCompletionRoutine,
|
||
&Event,
|
||
TRUE,
|
||
TRUE,
|
||
TRUE );
|
||
|
||
//
|
||
// Send the request and wait.
|
||
//
|
||
|
||
Status = IoCallDriver(Vcb->TargetDeviceObject, Irp);
|
||
|
||
if (Status == STATUS_PENDING) {
|
||
|
||
KeWaitForSingleObject( &Event,
|
||
Executive,
|
||
KernelMode,
|
||
FALSE,
|
||
NULL );
|
||
|
||
Status = Irp->IoStatus.Status;
|
||
}
|
||
|
||
_SEH2_TRY {
|
||
|
||
//
|
||
// Knock as many files down for this volume as we can.
|
||
//
|
||
|
||
FatFlushAndCleanVolume( IrpContext, Irp, Vcb, NoFlush );
|
||
|
||
//
|
||
// Now make our dismount happen. This may not vaporize the
|
||
// Vcb, of course, since there could be any number of handles
|
||
// outstanding since this is an out of band notification.
|
||
//
|
||
|
||
VcbDeleted = FatCheckForDismount( IrpContext, Vcb, TRUE );
|
||
|
||
} _SEH2_FINALLY {
|
||
|
||
//
|
||
// Release the Vcb if it could still remain.
|
||
//
|
||
|
||
if (!VcbDeleted) {
|
||
|
||
FatReleaseVcb( IrpContext, Vcb );
|
||
}
|
||
|
||
FatReleaseGlobal( IrpContext );
|
||
} _SEH2_END;
|
||
|
||
//
|
||
// Cleanup our IrpContext and complete the IRP.
|
||
//
|
||
|
||
FatCompleteRequest( IrpContext, Irp, Status );
|
||
|
||
return Status;
|
||
}
|
||
|
||
|
||
_Requires_lock_held_(_Global_critical_region_)
|
||
NTSTATUS
|
||
FatPnpCancelRemove (
|
||
PIRP_CONTEXT IrpContext,
|
||
PIRP Irp,
|
||
PVCB Vcb
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
This routine handles the PnP cancel remove operation. This is our
|
||
notification that a previously proposed remove (query) was eventually
|
||
vetoed by a component. The filesystem is responsible for cleaning up
|
||
and getting ready for more IO.
|
||
|
||
Arguments:
|
||
|
||
Irp - Supplies the Irp to process
|
||
|
||
Vcb - Supplies the volume being removed.
|
||
|
||
Return Value:
|
||
|
||
NTSTATUS - The return status for the operation
|
||
|
||
--*/
|
||
|
||
{
|
||
NTSTATUS Status = STATUS_SUCCESS;
|
||
|
||
PAGED_CODE();
|
||
|
||
//
|
||
// CANCEL - a previous QUERY has been rescinded as a result
|
||
// of someone vetoing. Since PnP cannot figure out who may
|
||
// have gotten the QUERY (think about it: stacked drivers),
|
||
// we must expect to deal with getting a CANCEL without having
|
||
// seen the QUERY.
|
||
//
|
||
// For FAT, this is quite easy. In fact, we can't get a
|
||
// CANCEL if the underlying drivers succeeded the QUERY since
|
||
// we disconnect the Vpb on our dismount initiation. This is
|
||
// actually pretty important because if PnP could get to us
|
||
// after the disconnect we'd be thoroughly unsynchronized
|
||
// with respect to the Vcb getting torn apart - merely referencing
|
||
// the volume device object is insufficient to keep us intact.
|
||
//
|
||
|
||
FatAcquireExclusiveVcb( IrpContext, Vcb );
|
||
FatReleaseGlobal( IrpContext);
|
||
|
||
//
|
||
// Unlock the volume. This is benign if we never had seen
|
||
// a QUERY.
|
||
//
|
||
|
||
(VOID)FatUnlockVolumeInternal( IrpContext, Vcb, NULL );
|
||
|
||
_SEH2_TRY {
|
||
|
||
//
|
||
// Send the request. The underlying driver will complete the
|
||
// IRP. Since we don't need to be in the way, simply ellide
|
||
// ourselves out of the IRP stack.
|
||
//
|
||
|
||
IoSkipCurrentIrpStackLocation( Irp );
|
||
|
||
Status = IoCallDriver(Vcb->TargetDeviceObject, Irp);
|
||
}
|
||
_SEH2_FINALLY {
|
||
|
||
FatReleaseVcb( IrpContext, Vcb );
|
||
} _SEH2_END;
|
||
|
||
FatCompleteRequest( IrpContext, NULL, STATUS_SUCCESS );
|
||
|
||
return Status;
|
||
}
|
||
|
||
|
||
//
|
||
// Local support routine
|
||
//
|
||
|
||
NTSTATUS
|
||
NTAPI
|
||
FatPnpCompletionRoutine (
|
||
_In_ PDEVICE_OBJECT DeviceObject,
|
||
_In_ PIRP Irp,
|
||
_In_reads_opt_(_Inexpressible_("varies")) PVOID Contxt
|
||
)
|
||
{
|
||
PKEVENT Event = (PKEVENT) Contxt;
|
||
|
||
KeSetEvent( Event, 0, FALSE );
|
||
|
||
return STATUS_MORE_PROCESSING_REQUIRED;
|
||
|
||
UNREFERENCED_PARAMETER( DeviceObject );
|
||
UNREFERENCED_PARAMETER( Contxt );
|
||
UNREFERENCED_PARAMETER( Irp );
|
||
}
|
||
|
||
|