- Convert the function headers to a Doxygen-compatible style

- Fix some typos

svn path=/trunk/; revision=39050

diff --git a/reactos/drivers/filesystems/fastfat_new/direntry.c b/reactos/drivers/filesystems/fastfat_new/direntry.c
index e67cdd7..fbce927 100644 (file)
--- a/reactos/drivers/filesystems/fastfat_new/direntry.c
+++ b/reactos/drivers/filesystems/fastfat_new/direntry.c
@@ -22,7 +22,7 @@ typedef struct _FAT_ENUM_DIR_CONTEXT
 {
     PFILE_OBJECT FileObject;
     LARGE_INTEGER PageOffset;
 {
     PFILE_OBJECT FileObject;
     LARGE_INTEGER PageOffset;

-    LONGLONG BeyoundLastEntryOffset;
+    LONGLONG BeyondLastEntryOffset;

     PVOID PageBuffer;
     PBCB PageBcb;
 
     PVOID PageBuffer;
     PBCB PageBcb;
 


@@ -512,9 +512,9 @@ FatEnumerateDirents(IN OUT PFAT_ENUM_DIR_CONTEXT Context,
     Entry = Add2Ptr(Context->PageBuffer, OffsetWithinPage, PUCHAR);
    /* Next Page Offset */
     PageOffset = Context->PageOffset.QuadPart + PAGE_SIZE;
     Entry = Add2Ptr(Context->PageBuffer, OffsetWithinPage, PUCHAR);
    /* Next Page Offset */
     PageOffset = Context->PageOffset.QuadPart + PAGE_SIZE;

-    if (PageOffset > Context->BeyoundLastEntryOffset)
+    if (PageOffset > Context->BeyondLastEntryOffset)

     {
     {

-        PageValidLength = (SIZE_T) (Context->BeyoundLastEntryOffset
+        PageValidLength = (SIZE_T) (Context->BeyondLastEntryOffset

             - Context->PageOffset.QuadPart);
     }
     BeyondLastEntry = Add2Ptr(Context->PageBuffer, PageValidLength, PUCHAR);
             - Context->PageOffset.QuadPart);
     }
     BeyondLastEntry = Add2Ptr(Context->PageBuffer, PageValidLength, PUCHAR);


@@ -545,7 +545,7 @@ FatEnumerateDirents(IN OUT PFAT_ENUM_DIR_CONTEXT Context,
         /* Check if this is the last available entry */
         if (PageValidLength < PAGE_SIZE)
             break;
         /* Check if this is the last available entry */
         if (PageValidLength < PAGE_SIZE)
             break;

-        /* We are getting beyound current page and
+        /* We are getting beyond current page and

          * are still in the continous run, map the next page.
          */
         Context->PageOffset.QuadPart = PageOffset;
          * are still in the continous run, map the next page.
          */
         Context->PageOffset.QuadPart = PageOffset;


@@ -564,9 +564,9 @@ FatEnumerateDirents(IN OUT PFAT_ENUM_DIR_CONTEXT Context,
         Entry = (PUCHAR) Context->PageBuffer;
        /* Next Page Offset */
         PageOffset = Context->PageOffset.QuadPart + PAGE_SIZE;
         Entry = (PUCHAR) Context->PageBuffer;
        /* Next Page Offset */
         PageOffset = Context->PageOffset.QuadPart + PAGE_SIZE;

-        if (PageOffset > Context->BeyoundLastEntryOffset)
+        if (PageOffset > Context->BeyondLastEntryOffset)

         {
         {

-            PageValidLength = (SIZE_T) (Context->BeyoundLastEntryOffset
+            PageValidLength = (SIZE_T) (Context->BeyondLastEntryOffset

                 - Context->PageOffset.QuadPart);
         }
         BeyondLastEntry = Add2Ptr(Context->PageBuffer, PageValidLength, PUCHAR);
                 - Context->PageOffset.QuadPart);
         }
         BeyondLastEntry = Add2Ptr(Context->PageBuffer, PageValidLength, PUCHAR);

diff --git a/reactos/drivers/filesystems/fastfat_new/fat.c b/reactos/drivers/filesystems/fastfat_new/fat.c
index 53bc3de..2c33267 100644 (file)
--- a/reactos/drivers/filesystems/fastfat_new/fat.c
+++ b/reactos/drivers/filesystems/fastfat_new/fat.c
@@ -16,7 +16,7 @@ typedef struct _FAT_SCAN_CONTEXT
 {
     PFILE_OBJECT FileObject;
     LARGE_INTEGER PageOffset;
 {
     PFILE_OBJECT FileObject;
     LARGE_INTEGER PageOffset;

-    LONGLONG BeyoundLastEntryOffset;
+    LONGLONG BeyondLastEntryOffset;

     PVOID PageBuffer;
     PBCB PageBcb;
 } FAT_SCAN_CONTEXT;
     PVOID PageBuffer;
     PBCB PageBcb;
 } FAT_SCAN_CONTEXT;


@@ -127,12 +127,14 @@ FAT_METHODS Fat32Methods = {
 
 /* FUNCTIONS ****************************************************************/
 
 
 /* FUNCTIONS ****************************************************************/
 

-/*
- * FUNCTION:
- *      Determines the index of the set bit.
- * ARGUMENTS:
- *      Number = Number having a single bit set.
- * RETURNS: Index of the set bit.
+/**
+ * Determines the index of the set bit.
+ *
+ * @param Number
+ * Number having a single bit set.
+ *
+ * @return
+ * Index of the set bit.

  */
 FORCEINLINE
 ULONG
  */
 FORCEINLINE
 ULONG


@@ -218,17 +220,25 @@ FatSetFat16ValueRun(IN OUT PFAT_SCAN_CONTEXT Context,
     ExRaiseStatus(STATUS_NOT_IMPLEMENTED);
 }
 
     ExRaiseStatus(STATUS_NOT_IMPLEMENTED);
 }
 

-/*
- * FUNCTION:
- *       Scans FAT32 for continous chain of clusters
- * ARGUMENTS:
- *       Context = Pointer to FAT_SCAN_CONTEXT.
- *       Index = Supplies the Index of the first cluster
- *          and receves the last index after the last
- *          cluster in the chain.
- *       CanWait = Indicates if the context allows blocking.
- * RETURNS: Value of the last claster terminated the scan.
- * NOTES: Raises STATUS_CANT_WAIT race condition.
+/**
+ * Scans FAT32 for continous chain of clusters
+ *
+ * @param Context
+ * Pointer to FAT_SCAN_CONTEXT.
+ *
+ * @param Index
+ * Supplies the Index of the first cluster
+ * and receves the last index after the last
+ * cluster in the chain.
+ *
+ * @param CanWait
+ * Indicates if the context allows blocking.
+ *
+ * @return
+ * Value of the last claster terminated the scan.
+ *
+ * @note
+ * Raises STATUS_CANT_WAIT race condition.

  */
 ULONG
 FatScanFat32ForContinousRun(IN OUT PFAT_SCAN_CONTEXT Context,
  */
 ULONG
 FatScanFat32ForContinousRun(IN OUT PFAT_SCAN_CONTEXT Context,


@@ -270,8 +280,8 @@ FatScanFat32ForContinousRun(IN OUT PFAT_SCAN_CONTEXT Context,
     Entry = Add2Ptr(Context->PageBuffer, OffsetWithinPage, PULONG);
     /* Next Page Offset */
     PageOffset = Context->PageOffset.QuadPart + PAGE_SIZE;
     Entry = Add2Ptr(Context->PageBuffer, OffsetWithinPage, PULONG);
     /* Next Page Offset */
     PageOffset = Context->PageOffset.QuadPart + PAGE_SIZE;

-    if (PageOffset > Context->BeyoundLastEntryOffset)
-        PageValidLength = (SIZE_T) (Context->BeyoundLastEntryOffset
+    if (PageOffset > Context->BeyondLastEntryOffset)
+        PageValidLength = (SIZE_T) (Context->BeyondLastEntryOffset

             - Context->PageOffset.QuadPart);
     BeyoudLastEntry = Add2Ptr(Context->PageBuffer, PageValidLength, PULONG);
     while (TRUE)
             - Context->PageOffset.QuadPart);
     BeyoudLastEntry = Add2Ptr(Context->PageBuffer, PageValidLength, PULONG);
     while (TRUE)


@@ -284,7 +294,7 @@ FatScanFat32ForContinousRun(IN OUT PFAT_SCAN_CONTEXT Context,
         /* Check if this is the last available entry */
         if (PageValidLength < PAGE_SIZE)
             break;
         /* Check if this is the last available entry */
         if (PageValidLength < PAGE_SIZE)
             break;

-        /* We are getting beyound current page and
+        /* We are getting beyond current page and

          * are still in the continous run, map the next page.
          */
         Context->PageOffset.QuadPart = PageOffset;
          * are still in the continous run, map the next page.
          */
         Context->PageOffset.QuadPart = PageOffset;


@@ -300,8 +310,8 @@ FatScanFat32ForContinousRun(IN OUT PFAT_SCAN_CONTEXT Context,
         Entry = (PULONG) Context->PageBuffer;
         /* Next Page Offset */
         PageOffset = Context->PageOffset.QuadPart + PAGE_SIZE;
         Entry = (PULONG) Context->PageBuffer;
         /* Next Page Offset */
         PageOffset = Context->PageOffset.QuadPart + PAGE_SIZE;

-        if (PageOffset > Context->BeyoundLastEntryOffset)
-            PageValidLength = (SIZE_T) (Context->BeyoundLastEntryOffset
+        if (PageOffset > Context->BeyondLastEntryOffset)
+            PageValidLength = (SIZE_T) (Context->BeyondLastEntryOffset

                 - Context->PageOffset.QuadPart);
         BeyoudLastEntry = Add2Ptr(Context->PageBuffer, PageValidLength, PULONG);
     }
                 - Context->PageOffset.QuadPart);
         BeyoudLastEntry = Add2Ptr(Context->PageBuffer, PageValidLength, PULONG);
     }


@@ -336,25 +346,37 @@ FatSetFat32ValueRun(IN OUT PFAT_SCAN_CONTEXT Context,
     ExRaiseStatus(STATUS_NOT_IMPLEMENTED);
 }
 
     ExRaiseStatus(STATUS_NOT_IMPLEMENTED);
 }
 

-/*
- * FUNCTION:
- *      Queries file MCB for the specified region [Vbo, Vbo + Length],
- *      returns the number of runs in the region as well as the first
- *      run of the range itself.
- *      If the specified region is not fully cached in MCB the routine
- *      scans FAT for the file and fills the MCB until the file offset
- *      (defined as Vbo + Length) is reached.
- * ARGUMENTS:
- *      Fcb = Pointer to FCB structure for the file.
- *      Vbo = Virtual Byte Offset in the file.
- *      Lbo = Receives the Value of Logical Byte offset corresponding
- *            to supplied Vbo Value.
- *      Length = Supplies file range length to be examined and recieves
- *            the length of first run.
- *      OutIndex = Recieves the index (in MCB cache) of first run.
- * RETURNS: Incremented index of the last run (+1).
- * NOTES: Should be called by I/O routines to split the I/O operation
- *      into sequential or parallel I/O operations.
+/**
+ * Queries file MCB for the specified region [Vbo, Vbo + Length],
+ * returns the number of runs in the region as well as the first
+ * run of the range itself.
+ * If the specified region is not fully cached in MCB the routine
+ * scans FAT for the file and fills the MCB until the file offset
+ * (defined as Vbo + Length) is reached.
+ *
+ * @param Fcb
+ * Pointer to FCB structure for the file.
+ *
+ * @param Vbo
+ * Virtual Byte Offset in the file.
+ *
+ * @param Lbo
+ * Receives the Value of Logical Byte offset corresponding
+ * to supplied Vbo Value.
+ *
+ * @param Length
+ * Supplies file range length to be examined and receives
+ * the length of first run.
+ *
+ * @param OutIndex
+ * Receives the index (in MCB cache) of first run.
+ *
+ * @return
+ * Incremented index of the last run (+1).
+ *
+ * @note
+ * Should be called by I/O routines to split the I/O operation
+ * into sequential or parallel I/O operations.

  */
 ULONG
 FatScanFat(IN PFCB Fcb,
  */
 ULONG
 FatScanFat(IN PFCB Fcb,


@@ -364,7 +386,7 @@ FatScanFat(IN PFCB Fcb,
            OUT PULONG Index,
            IN BOOLEAN CanWait)
 {
            OUT PULONG Index,
            IN BOOLEAN CanWait)
 {

-    LONGLONG CurrentLbo, CurrentVbo, BeyoundLastVbo, CurrentLength;
+    LONGLONG CurrentLbo, CurrentVbo, BeyondLastVbo, CurrentLength;

     ULONG Entry, NextEntry, NumberOfEntries, CurrentIndex;
     FAT_SCAN_CONTEXT Context;
     PVCB Vcb;
     ULONG Entry, NextEntry, NumberOfEntries, CurrentIndex;
     FAT_SCAN_CONTEXT Context;
     PVCB Vcb;


@@ -372,15 +394,15 @@ FatScanFat(IN PFCB Fcb,
     /* Some often used values */
     Vcb = Fcb->Vcb;
     CurrentIndex = 0;
     /* Some often used values */
     Vcb = Fcb->Vcb;
     CurrentIndex = 0;

-    BeyoundLastVbo = Vbo + *Length;
+    BeyondLastVbo = Vbo + *Length;

     CurrentLength = ((LONGLONG) Vcb->Clusters) << Vcb->BytesPerClusterLog;
     CurrentLength = ((LONGLONG) Vcb->Clusters) << Vcb->BytesPerClusterLog;

-    if (BeyoundLastVbo > CurrentLength) 
-        BeyoundLastVbo = CurrentLength;
+    if (BeyondLastVbo > CurrentLength) 
+        BeyondLastVbo = CurrentLength;

     /* Try to locate first run */
     if (FsRtlLookupLargeMcbEntry(&Fcb->Mcb, Vbo, Lbo, Length, NULL, NULL, Index))
     {
         /* Check if we have a single mapped run */
     /* Try to locate first run */
     if (FsRtlLookupLargeMcbEntry(&Fcb->Mcb, Vbo, Lbo, Length, NULL, NULL, Index))
     {
         /* Check if we have a single mapped run */

-        if (Vbo >= BeyoundLastVbo)
+        if (Vbo >= BeyondLastVbo)

             goto FatScanFcbFatExit;
     } else {
         *Length = 0L;
             goto FatScanFcbFatExit;
     } else {
         *Length = 0L;


@@ -401,14 +423,14 @@ FatScanFat(IN PFCB Fcb,
         {
             if (Entry < FAT_CLUSTER_LAST)
                 ExRaiseStatus(STATUS_FILE_CORRUPT_ERROR);
         {
             if (Entry < FAT_CLUSTER_LAST)
                 ExRaiseStatus(STATUS_FILE_CORRUPT_ERROR);

-                BeyoundLastVbo = 0LL;
+                BeyondLastVbo = 0LL;

         }
         CurrentIndex = 0L;
         CurrentVbo = 0LL;
     }
     RtlZeroMemory(&Context, sizeof(Context));
     Context.FileObject = Vcb->VolumeFileObject;
         }
         CurrentIndex = 0L;
         CurrentVbo = 0LL;
     }
     RtlZeroMemory(&Context, sizeof(Context));
     Context.FileObject = Vcb->VolumeFileObject;

-    while (CurrentVbo < BeyoundLastVbo)
+    while (CurrentVbo < BeyondLastVbo)

     {
         /* Locate Continous run starting with the current entry */
         NumberOfEntries = Entry;
     {
         /* Locate Continous run starting with the current entry */
         NumberOfEntries = Entry;


@@ -509,7 +531,7 @@ FatiInitializeVcb(PVCB Vcb)
         Vcb->Clusters = ClustersCapacity;
     Vcb->BytesPerCluster = SectorsToBytes(Vcb, Vcb->Bpb.SectorsPerCluster);
     Vcb->BytesPerClusterLog = FatPowerOfTwo(Vcb->BytesPerCluster);
         Vcb->Clusters = ClustersCapacity;
     Vcb->BytesPerCluster = SectorsToBytes(Vcb, Vcb->Bpb.SectorsPerCluster);
     Vcb->BytesPerClusterLog = FatPowerOfTwo(Vcb->BytesPerCluster);

-    Vcb->BeyoundLastClusterInFat = ((LONGLONG) Vcb->Clusters) * Vcb->IndexDepth / 0x8;
+    Vcb->BeyondLastClusterInFat = ((LONGLONG) Vcb->Clusters) * Vcb->IndexDepth / 0x8;

 }
 
 NTSTATUS
 }
 
 NTSTATUS

diff --git a/reactos/drivers/filesystems/fastfat_new/fatstruc.h b/reactos/drivers/filesystems/fastfat_new/fatstruc.h
index 89951cf..a9b0f0c 100644 (file)
--- a/reactos/drivers/filesystems/fastfat_new/fatstruc.h
+++ b/reactos/drivers/filesystems/fastfat_new/fatstruc.h
@@ -107,7 +107,7 @@ typedef struct _VCB
     ULONG IndexDepth;
     ULONG RootDirent;
     ULONG RootDirentSectors;
     ULONG IndexDepth;
     ULONG RootDirent;
     ULONG RootDirentSectors;

-    LONGLONG BeyoundLastClusterInFat;
+    LONGLONG BeyondLastClusterInFat;

     FAT_METHODS Methods;
     /*  Root Directory Fcb: */
     struct _FCB *RootFcb;
     FAT_METHODS Methods;
     /*  Root Directory Fcb: */
     struct _FCB *RootFcb;