]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdeModulePkg/Universal/Disk/UdfDxe/Udf.h
MdeModulePkg/UdfDxe: Refine enum member naming style
[mirror_edk2.git] / MdeModulePkg / Universal / Disk / UdfDxe / Udf.h
index 240d420ff543a041aaabe6dee692ec77539542eb..44c843fd4d33c7ab9cc24ef401c7daff44ffccaa 100644 (file)
          !IS_FID_PARENT_FILE (_Pointer)))\r
 \r
 typedef enum {\r
-  SHORT_ADS_SEQUENCE,\r
-  LONG_ADS_SEQUENCE,\r
-  EXTENDED_ADS_SEQUENCE,\r
-  INLINE_DATA\r
+  ShortAdsSequence,\r
+  LongAdsSequence,\r
+  ExtendedAdsSequence,\r
+  InlineData\r
 } UDF_FE_RECORDING_FLAGS;\r
 \r
 #define GET_FE_RECORDING_FLAGS(_Fe) \\r
@@ -118,26 +118,26 @@ typedef enum {
                   sizeof (UDF_DESCRIPTOR_TAG)))->Flags & 0x07)\r
 \r
 typedef enum {\r
-  EXTENT_RECORDED_AND_ALLOCATED,\r
-  EXTENT_NOT_RECORDED_BUT_ALLOCATED,\r
-  EXTENT_NOT_RECORDED_NOT_ALLOCATED,\r
-  EXTENT_IS_NEXT_EXTENT,\r
+  ExtentRecordedAndAllocated,\r
+  ExtentNotRecordedButAllocated,\r
+  ExtentNotRecordedNotAllocated,\r
+  ExtentIsNextExtent,\r
 } UDF_EXTENT_FLAGS;\r
 \r
 #define AD_LENGTH(_RecFlags) \\r
-  ((_RecFlags) == SHORT_ADS_SEQUENCE ? \\r
+  ((_RecFlags) == ShortAdsSequence ? \\r
    ((UINT64)(sizeof (UDF_SHORT_ALLOCATION_DESCRIPTOR))) : \\r
    ((UINT64)(sizeof (UDF_LONG_ALLOCATION_DESCRIPTOR))))\r
 \r
 #define GET_EXTENT_FLAGS(_RecFlags, _Ad) \\r
-  ((_RecFlags) == SHORT_ADS_SEQUENCE ? \\r
+  ((_RecFlags) == ShortAdsSequence ? \\r
    ((UDF_EXTENT_FLAGS)((((UDF_SHORT_ALLOCATION_DESCRIPTOR *)(_Ad))->ExtentLength >> \\r
             30) & 0x3)) : \\r
    ((UDF_EXTENT_FLAGS)((((UDF_LONG_ALLOCATION_DESCRIPTOR *)(_Ad))->ExtentLength >> \\r
             30) & 0x3)))\r
 \r
 #define GET_EXTENT_LENGTH(_RecFlags, _Ad) \\r
-  ((_RecFlags) == SHORT_ADS_SEQUENCE ? \\r
+  ((_RecFlags) == ShortAdsSequence ? \\r
    ((UINT32)((((UDF_SHORT_ALLOCATION_DESCRIPTOR *)(_Ad))->ExtentLength & \\r
           ~0xC0000000UL))) : \\r
    ((UINT32)((((UDF_LONG_ALLOCATION_DESCRIPTOR *)(_Ad))->ExtentLength & \\r
@@ -169,9 +169,9 @@ typedef struct {
 #pragma pack()\r
 \r
 typedef enum {\r
-  READ_FILE_GET_FILESIZE,\r
-  READ_FILE_ALLOCATE_AND_READ,\r
-  READ_FILE_SEEK_AND_READ,\r
+  ReadFileGetFileSize,\r
+  ReadFileAllocateAndRead,\r
+  ReadFileSeekAndRead,\r
 } UDF_READ_FILE_FLAGS;\r
 \r
 typedef struct {\r
@@ -659,7 +659,7 @@ UdfGetInfo (
 /**\r
   Set information about a file.\r
 \r
-  @param  File            Protocol instance pointer.\r
+  @param  This            Protocol instance pointer.\r
   @param  InformationType Type of information in Buffer.\r
   @param  BufferSize      Size of buffer.\r
   @param  Buffer          The data to write.\r
@@ -783,13 +783,14 @@ FindFileEntry (
   @param[in]   FilePath  File's absolute path.\r
   @param[in]   Root      Root directory file.\r
   @param[in]   Parent    Parent directory file.\r
+  @param[in]   Icb       ICB of Parent.\r
   @param[out]  File      Found file.\r
 \r
-  @retval EFI_SUCCESS          @p FilePath was found.\r
+  @retval EFI_SUCCESS          FilePath was found.\r
   @retval EFI_NO_MEDIA         The device has no media.\r
   @retval EFI_DEVICE_ERROR     The device reported an error.\r
   @retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.\r
-  @retval EFI_OUT_OF_RESOURCES The @p FilePath file was not found due to lack of\r
+  @retval EFI_OUT_OF_RESOURCES The FilePath file was not found due to lack of\r
                                resources.\r
 \r
 **/\r
@@ -813,7 +814,7 @@ FindFile (
   @param[in]      Volume         UDF volume information structure.\r
   @param[in]      ParentIcb      ICB of the parent file.\r
   @param[in]      FileEntryData  FE/EFE of the parent file.\r
-  @param[in out]  ReadDirInfo    Next read directory listing structure\r
+  @param[in, out] ReadDirInfo    Next read directory listing structure\r
                                  information.\r
   @param[out]     FoundFid       File Identifier Descriptor pointer.\r
 \r
@@ -913,7 +914,7 @@ CleanupFileInformation (
   @param[in]   File     File information structure.\r
   @param[out]  Size     Size of the file.\r
 \r
-  @retval EFI_SUCCESS          File size calculated and set in @p Size.\r
+  @retval EFI_SUCCESS          File size calculated and set in Size.\r
   @retval EFI_UNSUPPORTED      Extended Allocation Descriptors not supported.\r
   @retval EFI_NO_MEDIA         The device has no media.\r
   @retval EFI_DEVICE_ERROR     The device reported an error.\r
@@ -937,7 +938,7 @@ GetFileSize (
   @param[in]      File        File pointer.\r
   @param[in]      FileSize    Size of the file.\r
   @param[in]      FileName    Filename of the file.\r
-  @param[in out]  BufferSize  Size of the returned file infomation.\r
+  @param[in, out] BufferSize  Size of the returned file infomation.\r
   @param[out]     Buffer      Data of the returned file information.\r
 \r
   @retval EFI_SUCCESS          File information set.\r
@@ -991,9 +992,9 @@ GetVolumeSize (
   @param[in]      Volume        UDF volume information structure.\r
   @param[in]      File          File information structure.\r
   @param[in]      FileSize      Size of the file.\r
-  @param[in out]  FilePosition  File position.\r
-  @param[in out]  Buffer        File data.\r
-  @param[in out]  BufferSize    Read size.\r
+  @param[in, out] FilePosition  File position.\r
+  @param[in, out] Buffer        File data.\r
+  @param[in, out] BufferSize    Read size.\r
 \r
   @retval EFI_SUCCESS          File seeked and read.\r
   @retval EFI_UNSUPPORTED      Extended Allocation Descriptors not supported.\r
@@ -1037,7 +1038,7 @@ SupportUdfFileSystem (
 \r
   @param[in] FileName Filename.\r
 \r
-  @retval @p FileName Filename mangled.\r
+  @retval The mangled Filename.\r
 \r
 **/\r
 CHAR16 *\r