fat.h File Reference

#include <pshpack1.h>
#include <poppack.h>

Include dependency graph for fat.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	_FAT_BOOTSECTOR
struct	_FAT32_BOOTSECTOR
struct	_FATX_BOOTSECTOR
struct	DIRENTRY
struct	LFN_DIRENTRY
struct	FATX_DIRENTRY
struct	_FAT_FILE_INFO

Macros
#define	FAT_ATTR_NORMAL   0x00
#define	FAT_ATTR_READONLY   0x01
#define	FAT_ATTR_HIDDEN   0x02
#define	FAT_ATTR_SYSTEM   0x04
#define	FAT_ATTR_VOLUMENAME   0x08
#define	FAT_ATTR_DIRECTORY   0x10
#define	FAT_ATTR_ARCHIVE   0x20
#define	FAT_ATTR_LONG_NAME   (FAT_ATTR_READONLY | FAT_ATTR_HIDDEN | FAT_ATTR_SYSTEM | FAT_ATTR_VOLUMENAME)
#define	FAT12   1
#define	FAT16   2
#define	FAT32   3
#define	FATX16   4
#define	FATX32   5
#define	ISFATX(FT)   ((FT) == FATX16 || (FT) == FATX32)

Typedefs
typedef struct _FAT_BOOTSECTOR	FAT_BOOTSECTOR
typedef struct _FAT_BOOTSECTOR *	PFAT_BOOTSECTOR
typedef struct _FAT32_BOOTSECTOR	FAT32_BOOTSECTOR
typedef struct _FAT32_BOOTSECTOR *	PFAT32_BOOTSECTOR
typedef struct _FATX_BOOTSECTOR	FATX_BOOTSECTOR
typedef struct _FATX_BOOTSECTOR *	PFATX_BOOTSECTOR
typedef struct DIRENTRY *	PDIRENTRY
typedef struct LFN_DIRENTRY *	PLFN_DIRENTRY
typedef struct FATX_DIRENTRY *	PFATX_DIRENTRY
typedef struct _FAT_VOLUME_INFO *	PFAT_VOLUME_INFO
typedef struct _FAT_FILE_INFO	FAT_FILE_INFO
typedef struct _FAT_FILE_INFO *	PFAT_FILE_INFO

Functions
ULONGLONG	FatGetVolumeSize (_In_ ULONG DeviceId)
	Returns the size of the FAT volume laid on the storage media device opened via DeviceId.
const DEVVTBL *	FatMount (ULONG DeviceId)

Macro Definition Documentation

FAT12

#define FAT12   1

Definition at line 155 of file fat.h.

FAT16

#define FAT16   2

Definition at line 156 of file fat.h.

FAT32

#define FAT32   3

Definition at line 157 of file fat.h.

FAT_ATTR_ARCHIVE

#define FAT_ATTR_ARCHIVE   0x20

Definition at line 152 of file fat.h.

FAT_ATTR_DIRECTORY

#define FAT_ATTR_DIRECTORY   0x10

Definition at line 151 of file fat.h.

FAT_ATTR_HIDDEN

#define FAT_ATTR_HIDDEN   0x02

Definition at line 148 of file fat.h.

FAT_ATTR_LONG_NAME

#define FAT_ATTR_LONG_NAME   (FAT_ATTR_READONLY | FAT_ATTR_HIDDEN | FAT_ATTR_SYSTEM | FAT_ATTR_VOLUMENAME)

Definition at line 153 of file fat.h.

FAT_ATTR_NORMAL

#define FAT_ATTR_NORMAL   0x00

Definition at line 146 of file fat.h.

FAT_ATTR_READONLY

#define FAT_ATTR_READONLY   0x01

Definition at line 147 of file fat.h.

FAT_ATTR_SYSTEM

#define FAT_ATTR_SYSTEM   0x04

Definition at line 149 of file fat.h.

FAT_ATTR_VOLUMENAME

#define FAT_ATTR_VOLUMENAME   0x08

Definition at line 150 of file fat.h.

FATX16

#define FATX16   4

Definition at line 158 of file fat.h.

FATX32

#define FATX32   5

Definition at line 159 of file fat.h.

ISFATX

#define ISFATX

(

FT

)

((FT) == FATX16 || (FT) == FATX32)

Definition at line 161 of file fat.h.

Typedef Documentation

FAT32_BOOTSECTOR

typedef struct _FAT32_BOOTSECTOR FAT32_BOOTSECTOR

FAT_BOOTSECTOR

typedef struct _FAT_BOOTSECTOR FAT_BOOTSECTOR

FAT_FILE_INFO

typedef struct _FAT_FILE_INFO FAT_FILE_INFO

FATX_BOOTSECTOR

typedef struct _FATX_BOOTSECTOR FATX_BOOTSECTOR

PDIRENTRY

typedef struct DIRENTRY * PDIRENTRY

PFAT32_BOOTSECTOR

typedef struct _FAT32_BOOTSECTOR * PFAT32_BOOTSECTOR

PFAT_BOOTSECTOR

typedef struct _FAT_BOOTSECTOR * PFAT_BOOTSECTOR

PFAT_FILE_INFO

typedef struct _FAT_FILE_INFO * PFAT_FILE_INFO

PFAT_VOLUME_INFO

typedef struct _FAT_VOLUME_INFO* PFAT_VOLUME_INFO

Definition at line 163 of file fat.h.

PFATX_BOOTSECTOR

typedef struct _FATX_BOOTSECTOR * PFATX_BOOTSECTOR

PFATX_DIRENTRY

typedef struct FATX_DIRENTRY * PFATX_DIRENTRY

PLFN_DIRENTRY

typedef struct LFN_DIRENTRY * PLFN_DIRENTRY

Function Documentation

FatGetVolumeSize()

ULONGLONG FatGetVolumeSize

(

_In_ ULONG

DeviceId

)

Returns the size of the FAT volume laid on the storage media device opened via DeviceId.

Definition at line 1616 of file fat.c.

{
    PFAT_VOLUME_INFO Volume = FatVolumes[DeviceId];
    ASSERT(Volume);
    return (ULONGLONG)Volume->TotalSectors * Volume->BytesPerSector;
}

Referenced by FsGetVolumeSize().

FatMount()

const DEVVTBL * FatMount

(

ULONG

DeviceId

)

Definition at line 1645 of file fat.c.

{
    PFAT_VOLUME_INFO Volume;
    UCHAR Buffer[SECTOR_SIZE];
    PFAT_BOOTSECTOR BootSector = (PFAT_BOOTSECTOR)Buffer;
    PFAT32_BOOTSECTOR BootSector32 = (PFAT32_BOOTSECTOR)Buffer;
    PFATX_BOOTSECTOR BootSectorX = (PFATX_BOOTSECTOR)Buffer;
    FILEINFORMATION FileInformation;
    LARGE_INTEGER Position;
    ULONG Count;
    ULARGE_INTEGER SectorCount;
    ARC_STATUS Status;
 
    TRACE("Enter FatMount(%lu)\n", DeviceId);
 
    //
    // Allocate data for volume information
    //
    Volume = FrLdrTempAlloc(sizeof(FAT_VOLUME_INFO), TAG_FAT_VOLUME);
    if (!Volume)
        return NULL;
    RtlZeroMemory(Volume, sizeof(FAT_VOLUME_INFO));
 
    //
    // Read the BootSector
    //
    Position.QuadPart = 0;
    Status = ArcSeek(DeviceId, &Position, SeekAbsolute);
    if (Status != ESUCCESS)
    {
        FrLdrTempFree(Volume, TAG_FAT_VOLUME);
        return NULL;
    }
    Status = ArcRead(DeviceId, Buffer, sizeof(Buffer), &Count);
    if (Status != ESUCCESS || Count != sizeof(Buffer))
    {
        FrLdrTempFree(Volume, TAG_FAT_VOLUME);
        return NULL;
    }
 
    //
    // Check if BootSector is valid. If no, return early
    //
    if (!RtlEqualMemory(BootSector->FileSystemType, "FAT12   ", 8) &&
        !RtlEqualMemory(BootSector->FileSystemType, "FAT16   ", 8) &&
        !RtlEqualMemory(BootSector32->FileSystemType, "FAT32   ", 8) &&
        !RtlEqualMemory(BootSectorX->FileSystemType, "FATX", 4))
    {
        FrLdrTempFree(Volume, TAG_FAT_VOLUME);
        return NULL;
    }
 
    //
    // Determine sector count
    //
    Status = ArcGetFileInformation(DeviceId, &FileInformation);
    if (Status != ESUCCESS)
    {
        FrLdrTempFree(Volume, TAG_FAT_VOLUME);
        return NULL;
    }
    SectorCount.QuadPart = (FileInformation.EndingAddress.QuadPart - FileInformation.StartingAddress.QuadPart);
    SectorCount.QuadPart /= SECTOR_SIZE;
 
    //
    // Keep device id
    //
    Volume->DeviceId = DeviceId;
 
    //
    // Really open the volume
    //
    if (!FatOpenVolume(Volume, BootSector, SectorCount.QuadPart))
    {
        FrLdrTempFree(Volume, TAG_FAT_VOLUME);
        return NULL;
    }
 
    //
    // Remember FAT volume information
    //
    FatVolumes[DeviceId] = Volume;
 
    //
    // Return success
    //
    TRACE("FatMount(%lu) success\n", DeviceId);
    return (ISFATX(Volume->FatType) ? &FatXFuncTable : &FatFuncTable);
}