mirror of
https://github.com/reactos/reactos.git
synced 2024-08-14 15:16:27 +00:00
0daa5547d9
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!)
319 lines
7.8 KiB
C
319 lines
7.8 KiB
C
/*++
|
||
|
||
Copyright (c) 1989-2000 Microsoft Corporation
|
||
|
||
Module Name:
|
||
|
||
Shutdown.c
|
||
|
||
Abstract:
|
||
|
||
This module implements the file system shutdown routine for Fat
|
||
|
||
|
||
--*/
|
||
|
||
#include "fatprocs.h"
|
||
|
||
//
|
||
// Local debug trace level
|
||
//
|
||
|
||
#define Dbg (DEBUG_TRACE_SHUTDOWN)
|
||
|
||
#ifdef ALLOC_PRAGMA
|
||
#pragma alloc_text(PAGE, FatCommonShutdown)
|
||
#pragma alloc_text(PAGE, FatFsdShutdown)
|
||
#endif
|
||
|
||
|
||
_Function_class_(IRP_MJ_SHUTDOWN)
|
||
_Function_class_(DRIVER_DISPATCH)
|
||
NTSTATUS
|
||
NTAPI
|
||
FatFsdShutdown (
|
||
_In_ PVOLUME_DEVICE_OBJECT VolumeDeviceObject,
|
||
_Inout_ PIRP Irp
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
This routine implements the FSD part of shutdown. Note that Shutdown will
|
||
never be done asynchronously so we will never need the Fsp counterpart
|
||
to shutdown.
|
||
|
||
This is the shutdown routine for the Fat file system device driver.
|
||
This routine locks the global file system lock and then syncs all the
|
||
mounted volumes.
|
||
|
||
Arguments:
|
||
|
||
VolumeDeviceObject - Supplies the volume device object where the
|
||
file exists
|
||
|
||
Irp - Supplies the Irp being processed
|
||
|
||
Return Value:
|
||
|
||
NTSTATUS - Always STATUS_SUCCESS
|
||
|
||
--*/
|
||
|
||
{
|
||
NTSTATUS Status;
|
||
PIRP_CONTEXT IrpContext = NULL;
|
||
|
||
BOOLEAN TopLevel;
|
||
|
||
PAGED_CODE();
|
||
|
||
DebugTrace(+1, Dbg, "FatFsdShutdown\n", 0);
|
||
|
||
//
|
||
// Call the common shutdown routine.
|
||
//
|
||
|
||
FsRtlEnterFileSystem();
|
||
|
||
TopLevel = FatIsIrpTopLevel( Irp );
|
||
|
||
_SEH2_TRY {
|
||
|
||
IrpContext = FatCreateIrpContext( Irp, TRUE );
|
||
|
||
Status = FatCommonShutdown( 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, "FatFsdShutdown -> %08lx\n", Status);
|
||
|
||
UNREFERENCED_PARAMETER( VolumeDeviceObject );
|
||
|
||
return Status;
|
||
}
|
||
|
||
|
||
_Requires_lock_held_(_Global_critical_region_)
|
||
NTSTATUS
|
||
FatCommonShutdown (
|
||
IN PIRP_CONTEXT IrpContext,
|
||
IN PIRP Irp
|
||
)
|
||
|
||
/*++
|
||
|
||
Routine Description:
|
||
|
||
This is the common routine for shutdown called by both the fsd and
|
||
fsp threads.
|
||
|
||
Arguments:
|
||
|
||
Irp - Supplies the Irp being processed
|
||
|
||
Return Value:
|
||
|
||
NTSTATUS - The return status for the operation
|
||
|
||
--*/
|
||
|
||
{
|
||
KEVENT Event;
|
||
PLIST_ENTRY Links;
|
||
PVCB Vcb;
|
||
PIRP NewIrp;
|
||
IO_STATUS_BLOCK Iosb;
|
||
BOOLEAN VcbDeleted;
|
||
|
||
PAGED_CODE();
|
||
|
||
//
|
||
// Make sure we don't get any pop-ups, and write everything through.
|
||
//
|
||
|
||
SetFlag(IrpContext->Flags, IRP_CONTEXT_FLAG_DISABLE_POPUPS |
|
||
IRP_CONTEXT_FLAG_WRITE_THROUGH);
|
||
|
||
//
|
||
// Initialize an event for doing calls down to
|
||
// our target device objects.
|
||
//
|
||
|
||
KeInitializeEvent( &Event, NotificationEvent, FALSE );
|
||
|
||
//
|
||
// Indicate that shutdown has started. This is used in FatFspClose.
|
||
//
|
||
|
||
FatData.ShutdownStarted = TRUE;
|
||
|
||
//
|
||
// Get everyone else out of the way
|
||
//
|
||
|
||
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
|
||
|
||
(VOID) FatAcquireExclusiveGlobal( IrpContext );
|
||
|
||
#ifdef _MSC_VER
|
||
#pragma prefast( pop )
|
||
#endif
|
||
|
||
_SEH2_TRY {
|
||
|
||
//
|
||
// For every volume that is mounted we will flush the
|
||
// volume and then shutdown the target device objects.
|
||
//
|
||
|
||
Links = FatData.VcbQueue.Flink;
|
||
while (Links != &FatData.VcbQueue) {
|
||
|
||
Vcb = CONTAINING_RECORD(Links, VCB, VcbLinks);
|
||
|
||
Links = Links->Flink;
|
||
|
||
//
|
||
// If we have already been called before for this volume
|
||
// (and yes this does happen), skip this volume as no writes
|
||
// have been allowed since the first shutdown.
|
||
//
|
||
|
||
if ( FlagOn( Vcb->VcbState, VCB_STATE_FLAG_SHUTDOWN) ||
|
||
(Vcb->VcbCondition != VcbGood) ) {
|
||
|
||
continue;
|
||
}
|
||
|
||
FatAcquireExclusiveVolume( IrpContext, Vcb );
|
||
|
||
_SEH2_TRY {
|
||
|
||
(VOID)FatFlushVolume( IrpContext, Vcb, Flush );
|
||
|
||
//
|
||
// The volume is now clean, note it. We purge the
|
||
// volume file cache map before marking the volume
|
||
// clean incase there is a stale Bpb in the cache.
|
||
//
|
||
|
||
if (!FlagOn(Vcb->VcbState, VCB_STATE_FLAG_MOUNTED_DIRTY)) {
|
||
|
||
CcPurgeCacheSection( &Vcb->SectionObjectPointers,
|
||
NULL,
|
||
0,
|
||
FALSE );
|
||
|
||
FatMarkVolume( IrpContext, Vcb, VolumeClean );
|
||
}
|
||
|
||
} _SEH2_EXCEPT( EXCEPTION_EXECUTE_HANDLER ) {
|
||
|
||
FatResetExceptionState( IrpContext );
|
||
} _SEH2_END;
|
||
|
||
//
|
||
// Sometimes we take an excepion while flushing the volume, such
|
||
// as when autoconv has converted the volume and is rebooting.
|
||
// Even in that case we want to send the shutdown irp to the
|
||
// target device so it can know to flush its cache, if it has one.
|
||
//
|
||
|
||
_SEH2_TRY {
|
||
|
||
NewIrp = IoBuildSynchronousFsdRequest( IRP_MJ_SHUTDOWN,
|
||
Vcb->TargetDeviceObject,
|
||
NULL,
|
||
0,
|
||
NULL,
|
||
&Event,
|
||
&Iosb );
|
||
|
||
if (NewIrp != NULL) {
|
||
|
||
if (NT_SUCCESS(IoCallDriver( Vcb->TargetDeviceObject, NewIrp ))) {
|
||
|
||
(VOID) KeWaitForSingleObject( &Event,
|
||
Executive,
|
||
KernelMode,
|
||
FALSE,
|
||
NULL );
|
||
|
||
KeClearEvent( &Event );
|
||
}
|
||
}
|
||
|
||
} _SEH2_EXCEPT( EXCEPTION_EXECUTE_HANDLER ) {
|
||
|
||
FatResetExceptionState( IrpContext );
|
||
} _SEH2_END;
|
||
|
||
SetFlag( Vcb->VcbState, VCB_STATE_FLAG_SHUTDOWN );
|
||
|
||
//
|
||
// Attempt to punch the volume down.
|
||
//
|
||
|
||
VcbDeleted = FatCheckForDismount( IrpContext,
|
||
Vcb,
|
||
FALSE );
|
||
|
||
if (!VcbDeleted) {
|
||
|
||
FatReleaseVolume( IrpContext, Vcb );
|
||
}
|
||
}
|
||
|
||
} _SEH2_FINALLY {
|
||
|
||
|
||
FatReleaseGlobal( IrpContext );
|
||
|
||
//
|
||
// Unregister the file system.
|
||
//
|
||
|
||
IoUnregisterFileSystem( FatDiskFileSystemDeviceObject);
|
||
IoUnregisterFileSystem( FatCdromFileSystemDeviceObject);
|
||
IoDeleteDevice( FatDiskFileSystemDeviceObject);
|
||
IoDeleteDevice( FatCdromFileSystemDeviceObject);
|
||
|
||
FatCompleteRequest( IrpContext, Irp, STATUS_SUCCESS );
|
||
} _SEH2_END;
|
||
|
||
//
|
||
// And return to our caller
|
||
//
|
||
|
||
DebugTrace(-1, Dbg, "FatFsdShutdown -> STATUS_SUCCESS\n", 0);
|
||
|
||
return STATUS_SUCCESS;
|
||
}
|
||
|