fileinfo.c File Reference

#include "cdprocs.h"

Include dependency graph for fileinfo.c:

Go to the source code of this file.

Macros
#define	BugCheckFileId   (CDFS_BUG_CHECK_FILEINFO)

Functions
VOID	CdQueryBasicInfo (_In_ PIRP_CONTEXT IrpContext, _In_ PFCB Fcb, _Out_ PFILE_BASIC_INFORMATION Buffer, _Inout_ PULONG Length)
VOID	CdQueryStandardInfo (_In_ PIRP_CONTEXT IrpContext, _In_ PFCB Fcb, _Out_ PFILE_STANDARD_INFORMATION Buffer, _Inout_ PULONG Length)
VOID	CdQueryInternalInfo (_In_ PIRP_CONTEXT IrpContext, _In_ PFCB Fcb, _Out_ PFILE_INTERNAL_INFORMATION Buffer, _Inout_ PULONG Length)
VOID	CdQueryEaInfo (_In_ PIRP_CONTEXT IrpContext, _In_ PFCB Fcb, _Out_ PFILE_EA_INFORMATION Buffer, _Inout_ PULONG Length)
VOID	CdQueryPositionInfo (_In_ PIRP_CONTEXT IrpContext, _In_ PFILE_OBJECT FileObject, _Out_ PFILE_POSITION_INFORMATION Buffer, _Inout_ PULONG Length)
NTSTATUS	CdQueryNameInfo (_In_ PIRP_CONTEXT IrpContext, _In_ PFILE_OBJECT FileObject, _Out_ PFILE_NAME_INFORMATION Buffer, _Inout_ PULONG Length)
	_Requires_lock_held_ (_Global_critical_region_)
	_Function_class_ (FAST_IO_QUERY_BASIC_INFO)
	_Function_class_ (FAST_IO_QUERY_STANDARD_INFO)
	_Function_class_ (FAST_IO_QUERY_NETWORK_OPEN_INFO)
VOID	CdQueryNetworkInfo (_In_ PIRP_CONTEXT IrpContext, _In_ PFCB Fcb, _Out_ PFILE_NETWORK_OPEN_INFORMATION Buffer, _Inout_ PULONG Length)

Macro Definition Documentation

BugCheckFileId

#define BugCheckFileId   (CDFS_BUG_CHECK_FILEINFO)

Definition at line 23 of file fileinfo.c.

Function Documentation

_Function_class_() [1/3]

_Function_class_

(

FAST_IO_QUERY_BASIC_INFO

)

Definition at line 465 of file fileinfo.c.

{
    BOOLEAN Result = FALSE;
    TYPE_OF_OPEN TypeOfOpen;
 
    PFCB Fcb;
 
    PAGED_CODE();
 
    UNREFERENCED_PARAMETER( DeviceObject );
 
    ASSERT_FILE_OBJECT( FileObject );
 
    FsRtlEnterFileSystem();
 
    //
    //  Decode the file object to find the type of open and the data
    //  structures.
    //
 
    TypeOfOpen = CdFastDecodeFileObject( FileObject, &Fcb );
 
    //
    //  We only support this request on user file or directory objects.
    //
 
    if ((TypeOfOpen != UserFileOpen) &&
        ((TypeOfOpen != UserDirectoryOpen) || !FlagOn( Fcb->FcbState, FCB_STATE_INITIALIZED))) {
 
        FsRtlExitFileSystem();
        return FALSE;
    }
 
    //
    //  Acquire the file shared to access the Fcb.
    //
 
    if (!ExAcquireResourceSharedLite( Fcb->Resource, Wait )) {
 
        FsRtlExitFileSystem();
        return FALSE;
    }
 
    //
    //  Use a try-finally to facilitate cleanup.
    //
 
    _SEH2_TRY {
 
        //
        //  Only deal with 'good' Fcb's.
        //
 
        if (CdVerifyFcbOperation( NULL, Fcb )) {
 
            //
            //  Fill in the input buffer from the Fcb fields.
            //
 
            Buffer->CreationTime.QuadPart =
            Buffer->LastWriteTime.QuadPart =
            Buffer->ChangeTime.QuadPart = Fcb->CreationTime;
 
            Buffer->LastAccessTime.QuadPart = 0;
 
            Buffer->FileAttributes = Fcb->FileAttributes;
 
            //
            //  Update the IoStatus block with the size of this data.
            //
 
            IoStatus->Status = STATUS_SUCCESS;
            IoStatus->Information = sizeof( FILE_BASIC_INFORMATION );
 
            Result = TRUE;
        }
 
    } _SEH2_FINALLY {
 
        ExReleaseResourceLite( Fcb->Resource );
 
        FsRtlExitFileSystem();
    } _SEH2_END;
 
    return Result;
}

_Function_class_() [2/3]

_Function_class_

(

FAST_IO_QUERY_NETWORK_OPEN_INFO

)

Definition at line 721 of file fileinfo.c.

{
    BOOLEAN Result = FALSE;
    TYPE_OF_OPEN TypeOfOpen;
 
    PFCB Fcb;
 
    PAGED_CODE();
 
    UNREFERENCED_PARAMETER( DeviceObject );
 
    ASSERT_FILE_OBJECT( FileObject );
 
    FsRtlEnterFileSystem();
 
    //
    //  Decode the file object to find the type of open and the data
    //  structures.
    //
 
    TypeOfOpen = CdFastDecodeFileObject( FileObject, &Fcb );
 
    //
    //  We only support this request on user file or directory objects.
    //
 
    if ((TypeOfOpen != UserFileOpen) &&
        ((TypeOfOpen != UserDirectoryOpen) || !FlagOn( Fcb->FcbState, FCB_STATE_INITIALIZED))) {
 
        FsRtlExitFileSystem();
        return FALSE;
    }
 
    //
    //  Acquire the file shared to access the Fcb.
    //
 
    if (!ExAcquireResourceSharedLite( Fcb->Resource, Wait )) {
 
        FsRtlExitFileSystem();
        return FALSE;
    }
 
    //
    //  Use a try-finally to facilitate cleanup.
    //
 
    _SEH2_TRY {
 
        //
        //  Only deal with 'good' Fcb's.
        //
 
        if (CdVerifyFcbOperation( NULL, Fcb )) {
 
            //
            //  Fill in the input buffer from the Fcb fields.
            //
 
            Buffer->CreationTime.QuadPart =
            Buffer->LastWriteTime.QuadPart =
            Buffer->ChangeTime.QuadPart = Fcb->CreationTime;
 
            Buffer->LastAccessTime.QuadPart = 0;
 
            Buffer->FileAttributes = Fcb->FileAttributes;
 
            //
            //  Check whether this is a directory.
            //
 
            if (FlagOn( Fcb->FileAttributes, FILE_ATTRIBUTE_DIRECTORY )) {
 
                Buffer->AllocationSize.QuadPart =
                Buffer->EndOfFile.QuadPart = 0;
 
            } else {
 
                Buffer->AllocationSize.QuadPart = Fcb->AllocationSize.QuadPart;
                Buffer->EndOfFile.QuadPart = Fcb->FileSize.QuadPart;
            }
 
            //
            //  Update the IoStatus block with the size of this data.
            //
 
            IoStatus->Status = STATUS_SUCCESS;
            IoStatus->Information = sizeof( FILE_NETWORK_OPEN_INFORMATION );
 
            Result = TRUE;
        }
 
    } _SEH2_FINALLY {
 
        ExReleaseResourceLite( Fcb->Resource );
 
        FsRtlExitFileSystem();
    } _SEH2_END;
 
    return Result;
}

_Function_class_() [3/3]

_Function_class_

(

FAST_IO_QUERY_STANDARD_INFO

)

Definition at line 588 of file fileinfo.c.

{
    BOOLEAN Result = FALSE;
    TYPE_OF_OPEN TypeOfOpen;
 
    PFCB Fcb;
 
    PAGED_CODE();
 
    UNREFERENCED_PARAMETER( DeviceObject );
 
    ASSERT_FILE_OBJECT( FileObject );
 
    FsRtlEnterFileSystem();
 
    //
    //  Decode the file object to find the type of open and the data
    //  structures.
    //
 
    TypeOfOpen = CdFastDecodeFileObject( FileObject, &Fcb );
 
    //
    //  We only support this request on initialized user file or directory objects.
    //
 
    if ((TypeOfOpen != UserFileOpen) &&
        ((TypeOfOpen != UserDirectoryOpen) || !FlagOn( Fcb->FcbState, FCB_STATE_INITIALIZED ))) {
 
        FsRtlExitFileSystem();
        return FALSE;
    }
 
    //
    //  Acquire the file shared to access the Fcb.
    //
 
    if (!ExAcquireResourceSharedLite( Fcb->Resource, Wait )) {
 
        FsRtlExitFileSystem();
        return FALSE;
    }
 
    //
    //  Use a try-finally to facilitate cleanup.
    //
 
    _SEH2_TRY {
 
        //
        //  Only deal with 'good' Fcb's.
        //
 
        if (CdVerifyFcbOperation( NULL, Fcb )) {
 
            //
            //  Check whether this is a directory.
            //
 
            if (FlagOn( Fcb->FileAttributes, FILE_ATTRIBUTE_DIRECTORY )) {
 
                Buffer->AllocationSize.QuadPart =
                Buffer->EndOfFile.QuadPart = 0;
 
                Buffer->Directory = TRUE;
 
            } else {
 
                Buffer->AllocationSize.QuadPart = Fcb->AllocationSize.QuadPart;
                Buffer->EndOfFile.QuadPart = Fcb->FileSize.QuadPart;
 
                Buffer->Directory = FALSE;
            }
 
            Buffer->NumberOfLinks = 1;
            Buffer->DeletePending = FALSE;
 
            //
            //  Update the IoStatus block with the size of this data.
            //
 
            IoStatus->Status = STATUS_SUCCESS;
            IoStatus->Information = sizeof( FILE_STANDARD_INFORMATION );
 
            Result = TRUE;
        }
 
    } _SEH2_FINALLY {
 
        ExReleaseResourceLite( Fcb->Resource );
 
        FsRtlExitFileSystem();
    } _SEH2_END;
 
    return Result;
}

_Requires_lock_held_()

_Requires_lock_held_

(

_Global_critical_region_

)

Definition at line 77 of file fileinfo.c.

{
    NTSTATUS Status = STATUS_SUCCESS;
    PIO_STACK_LOCATION IrpSp = IoGetCurrentIrpStackLocation( Irp );
 
    ULONG Length;
    FILE_INFORMATION_CLASS FileInformationClass;
    PFILE_ALL_INFORMATION Buffer;
 
    TYPE_OF_OPEN TypeOfOpen;
    PFCB Fcb;
    PCCB Ccb;
 
    BOOLEAN ReleaseFcb = FALSE;
 
    PAGED_CODE();
 
    //
    //  Reference our input parameters to make things easier
    //
 
    Length = IrpSp->Parameters.QueryFile.Length;
    FileInformationClass = IrpSp->Parameters.QueryFile.FileInformationClass;
    Buffer = Irp->AssociatedIrp.SystemBuffer;
 
    //
    //  Decode the file object
    //
 
    TypeOfOpen = CdDecodeFileObject( IrpContext, IrpSp->FileObject, &Fcb, &Ccb );
 
    //
    //  Use a try-finally to facilitate cleanup.
    //
 
    _SEH2_TRY {
 
        //
        //  We only support query on file and directory handles.
        //
 
        switch (TypeOfOpen) {
 
        case UserDirectoryOpen :
        case UserFileOpen :
 
            //
            //  Acquire shared access to this file.  NOTE that this could be
            //  a recursive acquire,  if we already preacquired in
            //  CdAcquireForCreateSection().
            //
 
            CdAcquireFileShared( IrpContext, Fcb );
            ReleaseFcb = TRUE;
 
            //
            //  Make sure we have the correct sizes for a directory.
            //
 
            if (!FlagOn( Fcb->FcbState, FCB_STATE_INITIALIZED )) {
 
                NT_ASSERT( TypeOfOpen == UserDirectoryOpen );
                CdVerifyOrCreateDirStreamFile( IrpContext, Fcb);
            }
 
            //
            //  Make sure the Fcb is in a usable condition.  This will raise
            //  an error condition if the volume is unusable
            //
 
            CdVerifyFcbOperation( IrpContext, Fcb );
 
            //
            //  Based on the information class we'll do different
            //  actions.  Each of hte procedures that we're calling fills
            //  up the output buffer, if possible.  They will raise the
            //  status STATUS_BUFFER_OVERFLOW for an insufficient buffer.
            //  This is considered a somewhat unusual case and is handled
            //  more cleanly with the exception mechanism rather than
            //  testing a return status value for each call.
            //
 
            switch (FileInformationClass) {
 
            case FileAllInformation:
 
                //
                //  We don't allow this operation on a file opened by file Id.
                //
 
                if (FlagOn( Ccb->Flags, CCB_FLAG_OPEN_BY_ID )) {
 
                    Status = STATUS_INVALID_PARAMETER;
                    break;
                }
 
                //
                //  In this case go ahead and call the individual routines to
                //  fill in the buffer.  Only the name routine will
                //  pointer to the output buffer and then call the
                //  individual routines to fill in the buffer.
                //
 
                Length -= (sizeof( FILE_ACCESS_INFORMATION ) +
                           sizeof( FILE_MODE_INFORMATION ) +
                           sizeof( FILE_ALIGNMENT_INFORMATION ));
 
                CdQueryBasicInfo( IrpContext, Fcb, &Buffer->BasicInformation, &Length );
                CdQueryStandardInfo( IrpContext, Fcb, &Buffer->StandardInformation, &Length );
                CdQueryInternalInfo( IrpContext, Fcb, &Buffer->InternalInformation, &Length );
                CdQueryEaInfo( IrpContext, Fcb, &Buffer->EaInformation, &Length );
                CdQueryPositionInfo( IrpContext, IrpSp->FileObject, &Buffer->PositionInformation, &Length );
                Status = CdQueryNameInfo( IrpContext, IrpSp->FileObject, &Buffer->NameInformation, &Length );
 
                break;
 
            case FileBasicInformation:
 
                CdQueryBasicInfo( IrpContext, Fcb, (PFILE_BASIC_INFORMATION) Buffer, &Length );
                break;
 
            case FileStandardInformation:
 
                CdQueryStandardInfo( IrpContext, Fcb, (PFILE_STANDARD_INFORMATION) Buffer, &Length );
                break;
 
            case FileInternalInformation:
 
                CdQueryInternalInfo( IrpContext, Fcb, (PFILE_INTERNAL_INFORMATION) Buffer, &Length );
                break;
 
            case FileEaInformation:
 
                CdQueryEaInfo( IrpContext, Fcb, (PFILE_EA_INFORMATION) Buffer, &Length );
                break;
 
            case FilePositionInformation:
 
                CdQueryPositionInfo( IrpContext, IrpSp->FileObject, (PFILE_POSITION_INFORMATION) Buffer, &Length );
                break;
 
            case FileNameInformation:
 
                //
                //  We don't allow this operation on a file opened by file Id.
                //
 
                if (!FlagOn( Ccb->Flags, CCB_FLAG_OPEN_BY_ID )) {
 
                    Status = CdQueryNameInfo( IrpContext, IrpSp->FileObject, (PFILE_NAME_INFORMATION) Buffer, &Length );
 
                } else {
 
                    Status = STATUS_INVALID_PARAMETER;
                }
 
                break;
 
            case FileAlternateNameInformation:
 
                if (!FlagOn( Ccb->Flags, CCB_FLAG_OPEN_BY_ID )) {
 
                    Status = CdQueryAlternateNameInfo( IrpContext, Fcb, Ccb, (PFILE_NAME_INFORMATION) Buffer, &Length );
 
                } else {
 
                    Status = STATUS_INVALID_PARAMETER;
                }
 
                break;
 
            case FileNetworkOpenInformation:
 
                CdQueryNetworkInfo( IrpContext, Fcb, (PFILE_NETWORK_OPEN_INFORMATION) Buffer, &Length );
                break;
 
            default :
 
                Status = STATUS_INVALID_PARAMETER;
            }
 
            break;
 
        default :
 
            Status = STATUS_INVALID_PARAMETER;
        }
 
        //
        //  Set the information field to the number of bytes actually filled in
        //  and then complete the request
        //
 
        Irp->IoStatus.Information = IrpSp->Parameters.QueryFile.Length - Length;
 
    } _SEH2_FINALLY {
 
        //
        //  Release the file.
        //
 
        if (ReleaseFcb) {
 
            CdReleaseFile( IrpContext, Fcb );
        }
    } _SEH2_END;
 
    //
    //  Complete the request if we didn't raise.
    //
 
    CdCompleteRequest( IrpContext, Irp, Status );
 
    return Status;
}

CdQueryBasicInfo()

VOID CdQueryBasicInfo	(	_In_ PIRP_CONTEXT	IrpContext,
		_In_ PFCB	Fcb,
		_Out_ PFILE_BASIC_INFORMATION	Buffer,
		_Inout_ PULONG	Length
	)

Definition at line 864 of file fileinfo.c.

{
    PAGED_CODE();
 
    UNREFERENCED_PARAMETER( IrpContext );
 
    //
    //  We only support creation, last modify and last write times on Cdfs.
    //
 
    RtlZeroMemory(Buffer, sizeof(FILE_BASIC_INFORMATION));
 
    Buffer->LastWriteTime.QuadPart =
    Buffer->CreationTime.QuadPart =
    Buffer->ChangeTime.QuadPart = Fcb->CreationTime;
 
    Buffer->LastAccessTime.QuadPart = 0;
 
    Buffer->FileAttributes = Fcb->FileAttributes;
 
    //
    //  Update the length and status output variables
    //
 
    *Length -= sizeof( FILE_BASIC_INFORMATION );
 
    return;
}

CdQueryEaInfo()

VOID CdQueryEaInfo	(	_In_ PIRP_CONTEXT	IrpContext,
		_In_ PFCB	Fcb,
		_Out_ PFILE_EA_INFORMATION	Buffer,
		_Inout_ PULONG	Length
	)

Definition at line 1052 of file fileinfo.c.

{
    PAGED_CODE();
 
    UNREFERENCED_PARAMETER( IrpContext );
    UNREFERENCED_PARAMETER( Fcb );
 
    //
    //  No Ea's on Cdfs volumes.
    //
 
    Buffer->EaSize = 0;
    *Length -= sizeof( FILE_EA_INFORMATION );
 
    return;
}

CdQueryInternalInfo()

VOID CdQueryInternalInfo	(	_In_ PIRP_CONTEXT	IrpContext,
		_In_ PFCB	Fcb,
		_Out_ PFILE_INTERNAL_INFORMATION	Buffer,
		_Inout_ PULONG	Length
	)

Definition at line 1002 of file fileinfo.c.

{
    PAGED_CODE();
 
    UNREFERENCED_PARAMETER( IrpContext );
 
    //
    //  Index number is the file Id number in the Fcb.
    //
 
    Buffer->IndexNumber = Fcb->FileId;
    *Length -= sizeof( FILE_INTERNAL_INFORMATION );
 
    return;
}

CdQueryNameInfo()

NTSTATUS CdQueryNameInfo	(	_In_ PIRP_CONTEXT	IrpContext,
		_In_ PFILE_OBJECT	FileObject,
		_Out_ PFILE_NAME_INFORMATION	Buffer,
		_Inout_ PULONG	Length
	)

Definition at line 1158 of file fileinfo.c.

{
    NTSTATUS Status = STATUS_SUCCESS;
    ULONG LengthToCopy;
 
    PAGED_CODE();
 
    UNREFERENCED_PARAMETER( IrpContext );
 
    NT_ASSERT(*Length >= sizeof(ULONG));
 
    //
    //  Simply copy the name in the file object to the user's buffer.
    //
 
    //
    //  Place the size of the filename in the user's buffer and reduce the remaining
    //  size to match.
    //
 
    Buffer->FileNameLength = LengthToCopy = FileObject->FileName.Length;
    *Length -= sizeof(ULONG);
 
    if (LengthToCopy > *Length) {
 
        LengthToCopy = *Length;
        Status = STATUS_BUFFER_OVERFLOW;
    }
 
    RtlCopyMemory( Buffer->FileName, FileObject->FileName.Buffer, LengthToCopy );
 
    //
    //  Reduce the available bytes by the amount stored into this buffer.  In the overflow
    //  case, this simply drops to zero.  The returned filenamelength will indicate to the
    //  caller how much space is required.
    //
 
    *Length -= LengthToCopy;
 
    return Status;
}

CdQueryNetworkInfo()

VOID CdQueryNetworkInfo	(	_In_ PIRP_CONTEXT	IrpContext,
		_In_ PFCB	Fcb,
		_Out_ PFILE_NETWORK_OPEN_INFORMATION	Buffer,
		_Inout_ PULONG	Length
	)

Definition at line 1463 of file fileinfo.c.

{
    PAGED_CODE();
 
    UNREFERENCED_PARAMETER( IrpContext );
 
    //
    //  We only support creation, last modify and last write times on Cdfs.
    //
 
    Buffer->LastWriteTime.QuadPart =
    Buffer->CreationTime.QuadPart =
    Buffer->ChangeTime.QuadPart = Fcb->CreationTime;
 
    Buffer->LastAccessTime.QuadPart = 0;
 
    Buffer->FileAttributes = Fcb->FileAttributes;
 
    //
    //  We get the sizes from the header.  Return a size of zero
    //  for all directories.
    //
 
    if (FlagOn( Fcb->FileAttributes, FILE_ATTRIBUTE_DIRECTORY )) {
 
        Buffer->AllocationSize.QuadPart =
        Buffer->EndOfFile.QuadPart = 0;
 
    } else {
 
        Buffer->AllocationSize.QuadPart = Fcb->AllocationSize.QuadPart;
        Buffer->EndOfFile.QuadPart = Fcb->FileSize.QuadPart;
    }
 
    //
    //  Update the length and status output variables
    //
 
    *Length -= sizeof( FILE_NETWORK_OPEN_INFORMATION );
 
    return;
}

CdQueryPositionInfo()

VOID CdQueryPositionInfo	(	_In_ PIRP_CONTEXT	IrpContext,
		_In_ PFILE_OBJECT	FileObject,
		_Out_ PFILE_POSITION_INFORMATION	Buffer,
		_Inout_ PULONG	Length
	)

Definition at line 1103 of file fileinfo.c.

{
    PAGED_CODE();
 
    UNREFERENCED_PARAMETER( IrpContext );
 
    //
    //  Get the current position found in the file object.
    //
 
    Buffer->CurrentByteOffset = FileObject->CurrentByteOffset;
 
    //
    //  Update the length and status output variables
    //
 
    *Length -= sizeof( FILE_POSITION_INFORMATION );
 
    return;
}

CdQueryStandardInfo()

VOID CdQueryStandardInfo	(	_In_ PIRP_CONTEXT	IrpContext,
		_In_ PFCB	Fcb,
		_Out_ PFILE_STANDARD_INFORMATION	Buffer,
		_Inout_ PULONG	Length
	)

Definition at line 927 of file fileinfo.c.

{
    PAGED_CODE();
 
    UNREFERENCED_PARAMETER( IrpContext );
 
    //
    //  There is only one link and delete is never pending on a Cdrom file.
    //
 
    Buffer->NumberOfLinks = 1;
    Buffer->DeletePending = FALSE;
 
    //
    //  We get the sizes from the header.  Return a size of zero
    //  for all directories.
    //
 
    if (FlagOn( Fcb->FileAttributes, FILE_ATTRIBUTE_DIRECTORY )) {
 
        Buffer->AllocationSize.QuadPart =
        Buffer->EndOfFile.QuadPart = 0;
 
        Buffer->Directory = TRUE;
 
    } else {
 
        Buffer->AllocationSize.QuadPart = Fcb->AllocationSize.QuadPart;
        Buffer->EndOfFile.QuadPart = Fcb->FileSize.QuadPart;
 
        Buffer->Directory = FALSE;
    }
 
    //
    //  Update the length and status output variables
    //
 
    *Length -= sizeof( FILE_STANDARD_INFORMATION );
 
    return;
}