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