]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Include/Ppi/FirmwareVolume.h
Removed tabs and fixed some minor coding style issues. Also fixed typo in EFI_PEI_ENT...
[mirror_edk2.git] / MdePkg / Include / Ppi / FirmwareVolume.h
index 3cafd0c00316c23eeebb7d6c656d18c6c9bcd2be..953ea6ac60b108a4d3048769aee603a7e77fa000 100644 (file)
@@ -27,7 +27,7 @@
 // EFI_FIRMWARE_FILE_SYSTEM2_GUID is the PI Firmware Volume format.\r
 // \r
 \r
-typedef struct _EFI_PEI_FIRMWARE_VOLUME_PPI            EFI_PEI_FIRMWARE_VOLUME_PPI;\r
+typedef struct _EFI_PEI_FIRMWARE_VOLUME_PPI   EFI_PEI_FIRMWARE_VOLUME_PPI;\r
 \r
 \r
 /**\r
@@ -40,26 +40,26 @@ typedef struct _EFI_PEI_FIRMWARE_VOLUME_PPI         EFI_PEI_FIRMWARE_VOLUME_PPI;
   from the EFI_FIRMWARE_VOLUME_INFO_PPI.\r
   \r
   \r
-  @param This        Points to this instance of the\r
+  @param This         Points to this instance of the\r
                       EFI_PEI_FIRMWARE_VOLUME_PPI\r
-  @param Buffer                        Points to the start of the buffer.\r
-  @param BufferSize    Size of the buffer.\r
-  @param FvHandle              Points to the returned firmware volume\r
+  @param Buffer       Points to the start of the buffer.\r
+  @param BufferSize   Size of the buffer.\r
+  @param FvHandle     Points to the returned firmware volume\r
                       handle. The firmware volume handle must\r
                       be unique within the system. \r
 \r
 \r
-  @retval EFI_SUCCESS                                  Firmware volume handle.\r
-  @retval EFI_VOLUME_CORRUPTED         Volume was corrupt.\r
+  @retval EFI_SUCCESS           Firmware volume handle.\r
+  @retval EFI_VOLUME_CORRUPTED  Volume was corrupt.\r
 \r
 **/\r
 typedef\r
 EFI_STATUS\r
 (EFIAPI *EFI_PEI_FV_PROCESS_FV) (\r
-       IN CONST        EFI_PEI_FIRMWARE_VOLUME_PPI *This,\r
-       IN CONST        VOID                                                                                            *Buffer,\r
-       IN CONST        UINTN                                                                                   BufferSize,\r
-       OUT                     EFI_PEI_FV_HANDLE                                       *FvHandle\r
+  IN CONST  EFI_PEI_FIRMWARE_VOLUME_PPI *This,\r
+  IN CONST  VOID                        *Buffer,\r
+  IN CONST  UINTN                       BufferSize,\r
+  OUT       EFI_PEI_FV_HANDLE           *FvHandle\r
 );\r
 \r
 \r
@@ -73,76 +73,76 @@ EFI_STATUS
   from the EFI_FIRMWARE_VOLUME_INFO_PPI.\r
   \r
   \r
-  @param This        Points to this instance of the\r
+  @param This         Points to this instance of the\r
                       EFI_PEI_FIRMWARE_VOLUME_PPI\r
-  @param Buffer                        Points to the start of the buffer.\r
-  @param BufferSize    Size of the buffer.\r
-  @param FvHandle              Points to the returned firmware volume\r
+  @param Buffer       Points to the start of the buffer.\r
+  @param BufferSize   Size of the buffer.\r
+  @param FvHandle     Points to the returned firmware volume\r
                       handle. The firmware volume handle must\r
                       be unique within the system. \r
 \r
 \r
-  @retval EFI_SUCCESS                                  Firmware volume handle.\r
-  @retval EFI_VOLUME_CORRUPTED         Volume was corrupt.\r
+  @retval EFI_SUCCESS           Firmware volume handle.\r
+  @retval EFI_VOLUME_CORRUPTED  Volume was corrupt.\r
 \r
 **/\r
 \r
 /**\r
   This service enables PEI modules to discover additional firmware files. The FileHandle must be\r
-       unique within the system.\r
+  unique within the system.\r
 \r
-  @param This                  Points to this instance of the\r
-                                                                               EFI_PEI_FIRMWARE_VOLUME_PPI. SearchType A filter\r
-                                                                               to find only files of this type. Type\r
-                                                                               EFI_FV_FILETYPE_ALL causes no filtering to be\r
-                                                                               done.\r
-  @param FvHandle      Handle of firmware volume in which to\r
-                                                                               search.\r
+  @param This       Points to this instance of the\r
+                    EFI_PEI_FIRMWARE_VOLUME_PPI. SearchType A filter\r
+                    to find only files of this type. Type\r
+                    EFI_FV_FILETYPE_ALL causes no filtering to be\r
+                    done.\r
+  @param FvHandle   Handle of firmware volume in which to\r
+                    search.\r
 \r
-  @param FileHandle    Points to the current handle from which to\r
+  @param FileHandle Points to the current handle from which to\r
                     begin searching or NULL to start at the\r
                     beginning of the firmware volume. Updated\r
                     upon return to reflect the file found.\r
 \r
 \r
-  @retval EFI_SUCCESS  The file was found.\r
+  @retval EFI_SUCCESS   The file was found.\r
   @retval EFI_NOT_FOUND The file was not found. FileHandle\r
-                                                                                               contains NULL.\r
+                        contains NULL.\r
 **/ \r
 typedef EFI_STATUS\r
 (EFIAPI *EFI_PEI_FV_FIND_FILE_TYPE) ( \r
-       IN CONST        EFI_PEI_FIRMWARE_VOLUME_PPI     *This, \r
-       IN CONST  EFI_FV_FILETYPE                                                       SearchType, \r
-       IN CONST  EFI_PEI_FV_HANDLE                                             FvHandle,\r
-       IN OUT EFI_PEI_FILE_HANDLE                                                      *FileHandle \r
+  IN CONST  EFI_PEI_FIRMWARE_VOLUME_PPI   *This, \r
+  IN CONST  EFI_FV_FILETYPE               SearchType, \r
+  IN CONST  EFI_PEI_FV_HANDLE             FvHandle,\r
+  IN OUT EFI_PEI_FILE_HANDLE              *FileHandle \r
 );\r
 \r
 \r
 /**\r
    \r
-       This service searches for files with a specific name, within\r
-       either the specified firmware volume or all firmware volumes.\r
+  This service searches for files with a specific name, within\r
+  either the specified firmware volume or all firmware volumes.\r
 \r
   @param This   Points to this instance of the\r
                 EFI_PEI_FIRMWARE_VOLUME_PPI.\r
 \r
-  @param FileName      A pointer to the name of the file to find\r
+  @param FileName   A pointer to the name of the file to find\r
                     within the firmware volume.\r
 \r
-  @param FvHandle      Upon entry, the pointer to the firmware\r
+  @param FvHandle   Upon entry, the pointer to the firmware\r
                     volume to search or NULL if all firmware\r
                     volumes should be searched. Upon exit, the\r
                     actual firmware volume in which the file was\r
                     found.\r
 \r
-  @param FileHandle    Upon exit, points to the found file's\r
+  @param FileHandle   Upon exit, points to the found file's\r
                       handle or NULL if it could not be found.\r
 \r
-  @retval EFI_SUCCESS  File was found.\r
+  @retval EFI_SUCCESS   File was found.\r
 \r
-  @param EFI_NOT_FOUND         File was not found.\r
+  @param EFI_NOT_FOUND  File was not found.\r
 \r
-  @param EFI_INVALID_PARAMETER         FvHandle or FileHandle or\r
+  @param EFI_INVALID_PARAMETER  FvHandle or FileHandle or\r
                                 FileName was NULL.\r
 \r
 \r
@@ -150,29 +150,29 @@ typedef EFI_STATUS
 typedef\r
 EFI_STATUS\r
 (EFIAPI *EFI_PEI_FV_FIND_FILE_NAME) (\r
-       IN CONST        EFI_PEI_FIRMWARE_VOLUME_PPI *This,\r
-       IN CONST        EFI_GUID                                                                                *FileName,\r
-       IN CONST        EFI_PEI_FV_HANDLE                                       FvHandle,\r
-       OUT                     EFI_PEI_FILE_HANDLE                             *FileHandle\r
+  IN CONST  EFI_PEI_FIRMWARE_VOLUME_PPI *This,\r
+  IN CONST  EFI_GUID                    *FileName,\r
+  IN CONST  EFI_PEI_FV_HANDLE           FvHandle,\r
+  OUT       EFI_PEI_FILE_HANDLE         *FileHandle\r
 );\r
 \r
 \r
 /**\r
   This function returns information about a specific\r
-       file, including its file name, type, attributes, starting\r
+  file, including its file name, type, attributes, starting\r
   address and size. \r
    \r
-  @param This                  Points to this instance of the\r
-                                                                               EFI_PEI_FIRMWARE_VOLUME_PPI.\r
+  @param This       Points to this instance of the\r
+                    EFI_PEI_FIRMWARE_VOLUME_PPI.\r
 \r
   @param FileHandle Handle of the file.\r
 \r
-  @param FileInfo      Upon exit, points to the file????s\r
-                                                                               information.\r
+  @param FileInfo   Upon exit, points to the file????s\r
+                    information.\r
 \r
-  @retval EFI_SUCCESS                                          File information returned.\r
+  @retval EFI_SUCCESS             File information returned.\r
   \r
-  @retval EFI_INVALID_PARAMETER        If FileHandle does not\r
+  @retval EFI_INVALID_PARAMETER   If FileHandle does not\r
                                   represent a valid file.\r
                                   EFI_INVALID_PARAMETER If\r
                                   FileInfo is NULL\r
@@ -181,88 +181,88 @@ EFI_STATUS
 \r
 typedef\r
 EFI_STATUS (EFIAPI *EFI_PEI_FV_GET_FILE_INFO) (\r
-       IN      CONST   EFI_PEI_FIRMWARE_VOLUME_PPI     *This, \r
-       IN  CONST       EFI_PEI_FILE_HANDLE                                     FileHandle, \r
-       OUT                     EFI_FV_FILE_INFO                                                        *FileInfo\r
+  IN  CONST EFI_PEI_FIRMWARE_VOLUME_PPI   *This, \r
+  IN  CONST EFI_PEI_FILE_HANDLE           FileHandle, \r
+  OUT       EFI_FV_FILE_INFO              *FileInfo\r
 );\r
 \r
 /**\r
-       This function returns information about the firmware\r
+  This function returns information about the firmware\r
   volume.\r
   \r
-  @param This                  Points to this instance of the\r
-                                                                               EFI_PEI_FIRMWARE_VOLUME_PPI.\r
+  @param This       Points to this instance of the\r
+                    EFI_PEI_FIRMWARE_VOLUME_PPI.\r
   \r
-  @param FvHandle      Handle to the firmware handle.\r
+  @param FvHandle   Handle to the firmware handle.\r
   \r
   @param VolumeInfo Points to the returned firmware volume\r
                     information.\r
   \r
   \r
-  @retval EFI_SUCCESS                                          Information returned\r
+  @retval EFI_SUCCESS             Information returned\r
                                   successfully.\r
   \r
-  @retval EFI_INVALID_PARAMETER        FvHandle does not indicate a\r
-                                                                                                                                       valid firmware volume or VolumeInfo is NULL\r
+  @retval EFI_INVALID_PARAMETER   FvHandle does not indicate a\r
+                                  valid firmware volume or VolumeInfo is NULL\r
 **/ \r
 typedef\r
 EFI_STATUS (EFIAPI *EFI_PEI_FV_GET_INFO)(\r
-       IN CONST        EFI_PEI_FIRMWARE_VOLUME_PPI     *This, \r
-       IN CONST        EFI_PEI_FV_HANDLE                                               FvHandle, \r
-       OUT                     EFI_FV_INFO                                                                     *VolumeInfo\r
+  IN CONST  EFI_PEI_FIRMWARE_VOLUME_PPI   *This, \r
+  IN CONST  EFI_PEI_FV_HANDLE             FvHandle, \r
+  OUT       EFI_FV_INFO                   *VolumeInfo\r
 );\r
 \r
 /**\r
   This service enables PEI modules to discover sections of a given type within a valid file.\r
   \r
-  @param This  Points to this instance of the\r
+  @param This   Points to this instance of the\r
                 EFI_PEI_FIRMWARE_VOLUME_PPI.\r
   \r
-  @param SearchType    A filter to find only sections of this\r
+  @param SearchType   A filter to find only sections of this\r
                       type.\r
   \r
-  @param FileHandle    Handle of firmware file in which to\r
+  @param FileHandle   Handle of firmware file in which to\r
                       search.\r
   \r
   @param SectionData  Updated upon  return to point to the\r
                       section found.\r
   \r
-  @retval EFI_SUCCESS          Section was found.\r
+  @retval EFI_SUCCESS     Section was found.\r
   \r
-  @retval EFI_NOT_FOUND        Section of the specified type was not\r
-                                                                                                       found. SectionData contains NULL.\r
+  @retval EFI_NOT_FOUND   Section of the specified type was not\r
+                          found. SectionData contains NULL.\r
 **/\r
 typedef\r
 EFI_STATUS\r
 (EFIAPI *EFI_PEI_FV_FIND_SECTION) (\r
-       IN CONST        EFI_PEI_FIRMWARE_VOLUME_PPI     *This,\r
-       IN CONST        EFI_SECTION_TYPE                                                        SearchType,\r
-       IN CONST        EFI_PEI_FILE_HANDLE                                     FileHandle,\r
-       OUT                     VOID                                                                                                    **SectionData\r
+  IN CONST  EFI_PEI_FIRMWARE_VOLUME_PPI   *This,\r
+  IN CONST  EFI_SECTION_TYPE              SearchType,\r
+  IN CONST  EFI_PEI_FILE_HANDLE           FileHandle,\r
+  OUT       VOID                          **SectionData\r
 );\r
 \r
 \r
 \r
 /*\r
-       This PPI provides functions for accessing a memory-mapped firmware volume of a specific format.\r
+  This PPI provides functions for accessing a memory-mapped firmware volume of a specific format.\r
 \r
-       @param  ProcessVolume                   Process a firmware volume and create a volume handle.\r
-       @param  FindFileByType                  Find all files of a specific type.\r
-       @param  FindFileByName                  Find the file with a specific name.\r
-       @param  GetFileInfo                             Return the information about a specific file\r
-       @param  GetVolumeInfo                   Return the firmware volume attributes.\r
-       @param  FindSectionByType       Find all sections of a specific type.\r
+  @param  ProcessVolume       Process a firmware volume and create a volume handle.\r
+  @param  FindFileByType      Find all files of a specific type.\r
+  @param  FindFileByName      Find the file with a specific name.\r
+  @param  GetFileInfo         Return the information about a specific file\r
+  @param  GetVolumeInfo       Return the firmware volume attributes.\r
+  @param  FindSectionByType   Find all sections of a specific type.\r
 \r
 **/\r
 struct _EFI_PEI_FIRMWARE_VOLUME_PPI {\r
-       EFI_PEI_FV_PROCESS_FV                   ProcessVolume;\r
-       EFI_PEI_FV_FIND_FILE_TYPE       FindFileByType;\r
-       EFI_PEI_FV_FIND_FILE_NAME       FindFileByName;\r
-       EFI_PEI_FV_GET_FILE_INFO                GetFileInfo;\r
-       EFI_PEI_FV_GET_INFO                             GetVolumeInfo;\r
-       EFI_PEI_FV_FIND_SECTION                 FindSectionByType;\r
+  EFI_PEI_FV_PROCESS_FV       ProcessVolume;\r
+  EFI_PEI_FV_FIND_FILE_TYPE   FindFileByType;\r
+  EFI_PEI_FV_FIND_FILE_NAME   FindFileByName;\r
+  EFI_PEI_FV_GET_FILE_INFO    GetFileInfo;\r
+  EFI_PEI_FV_GET_INFO         GetVolumeInfo;\r
+  EFI_PEI_FV_FIND_SECTION     FindSectionByType;\r
 } ;\r
 \r
-extern EFI_GUID        gEfiPeiFirmwareVolumePpiGuid;\r
+extern EFI_GUID gEfiPeiFirmwareVolumePpiGuid;\r
 \r
 #endif \r