MdeModulePkg/Udf: Refine function description comments

Cc: Paulo Alcantara <pcacjr@zytor.com>
Cc: Ruiyu Ni <ruiyu.ni@intel.com>
Cc: Star Zeng <star.zeng@intel.com>
Cc: Eric Dong <eric.dong@intel.com>
Cc: Dandan Bi <dandan.bi@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Paulo Alcantara <pcacjr@zytor.com>
Reviewed-by: Star Zeng <star.zeng@intel.com>
This commit is contained in:
Hao Wu 2017-09-14 13:19:13 +08:00
parent 12b83f5664
commit 077f8c4372
5 changed files with 345 additions and 92 deletions

View File

@ -40,6 +40,18 @@ UDF_DEVICE_PATH gUdfDevicePath = {
} }
}; };
/**
Find the anchor volume descriptor pointer.
@param[in] BlockIo BlockIo interface.
@param[in] DiskIo DiskIo interface.
@param[out] AnchorPoint Anchor volume descriptor pointer.
@retval EFI_SUCCESS Anchor volume descriptor pointer found.
@retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.
@retval other Anchor volume descriptor pointer not found.
**/
EFI_STATUS EFI_STATUS
FindAnchorVolumeDescriptorPointer ( FindAnchorVolumeDescriptorPointer (
IN EFI_BLOCK_IO_PROTOCOL *BlockIo, IN EFI_BLOCK_IO_PROTOCOL *BlockIo,

View File

@ -861,7 +861,7 @@ UdfGetInfo (
/** /**
Set information about a file. Set information about a file.
@param File Protocol instance pointer. @param This Protocol instance pointer.
@param InformationType Type of information in Buffer. @param InformationType Type of information in Buffer.
@param BufferSize Size of buffer. @param BufferSize Size of buffer.
@param Buffer The data to write. @param Buffer The data to write.

View File

@ -14,6 +14,14 @@
#include "Udf.h" #include "Udf.h"
/**
Trim the leading and trailing spaces for a give Unicode string.
@param[in] String The Unicode string to trim.
@return A pointer to the trimmed string.
**/
CHAR16 * CHAR16 *
TrimString ( TrimString (
IN CHAR16 *String IN CHAR16 *String
@ -35,6 +43,14 @@ TrimString (
return String; return String;
} }
/**
Replace the content of a Unicode string with the content of another Unicode
string.
@param[in] Destination A pointer to a Unicode string.
@param[in] Source A pointer to a Unicode string.
**/
VOID VOID
ReplaceLeft ( ReplaceLeft (
IN CHAR16 *Destination, IN CHAR16 *Destination,
@ -49,6 +65,15 @@ ReplaceLeft (
} }
} }
/**
Remove one or more consecutive backslashes starting from the second character
of a given Unicode string.
@param[in] String A pointer to a Unicode string.
@return A pointer to the modified string.
**/
CHAR16 * CHAR16 *
ExcludeTrailingBackslashes ( ExcludeTrailingBackslashes (
IN CHAR16 *String IN CHAR16 *String
@ -85,7 +110,7 @@ Exit:
@param[in] FileName Filename. @param[in] FileName Filename.
@retval @p FileName Filename mangled. @retval The mangled Filename.
**/ **/
CHAR16 * CHAR16 *

View File

@ -14,6 +14,18 @@
#include "Udf.h" #include "Udf.h"
/**
Find the anchor volume descriptor pointer.
@param[in] BlockIo BlockIo interface.
@param[in] DiskIo DiskIo interface.
@param[out] AnchorPoint Anchor volume descriptor pointer.
@retval EFI_SUCCESS Anchor volume descriptor pointer found.
@retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.
@retval other Anchor volume descriptor pointer not found.
**/
EFI_STATUS EFI_STATUS
FindAnchorVolumeDescriptorPointer ( FindAnchorVolumeDescriptorPointer (
IN EFI_BLOCK_IO_PROTOCOL *BlockIo, IN EFI_BLOCK_IO_PROTOCOL *BlockIo,
@ -58,6 +70,22 @@ FindAnchorVolumeDescriptorPointer (
return EFI_VOLUME_CORRUPTED; return EFI_VOLUME_CORRUPTED;
} }
/**
Save the content of Logical Volume Descriptors and Partitions Descriptors in
memory.
@param[in] BlockIo BlockIo interface.
@param[in] DiskIo DiskIo interface.
@param[in] AnchorPoint Anchor volume descriptor pointer.
@param[out] Volume UDF volume information structure.
@retval EFI_SUCCESS The descriptors were saved.
@retval EFI_OUT_OF_RESOURCES The descriptors were not saved due to lack of
resources.
@retval other The descriptors were not saved due to
ReadDisk error.
**/
EFI_STATUS EFI_STATUS
StartMainVolumeDescriptorSequence ( StartMainVolumeDescriptorSequence (
IN EFI_BLOCK_IO_PROTOCOL *BlockIo, IN EFI_BLOCK_IO_PROTOCOL *BlockIo,
@ -211,11 +239,17 @@ Error_Alloc_Pds:
return Status; return Status;
} }
// /**
// Return a Partition Descriptor given a Long Allocation Descriptor. This is Return a Partition Descriptor given a Long Allocation Descriptor. This is
// necessary to calculate the right extent (LongAd) offset which is added up necessary to calculate the right extent (LongAd) offset which is added up
// with partition's starting location. with partition's starting location.
//
@param[in] Volume Volume information pointer.
@param[in] LongAd Long Allocation Descriptor pointer.
@return A pointer to a Partition Descriptor.
**/
UDF_PARTITION_DESCRIPTOR * UDF_PARTITION_DESCRIPTOR *
GetPdFromLongAd ( GetPdFromLongAd (
IN UDF_VOLUME_INFO *Volume, IN UDF_VOLUME_INFO *Volume,
@ -270,9 +304,15 @@ GetPdFromLongAd (
return NULL; return NULL;
} }
// /**
// Return logical sector number of a given Long Allocation Descriptor. Return logical sector number of a given Long Allocation Descriptor.
//
@param[in] Volume Volume information pointer.
@param[in] LongAd Long Allocation Descriptor pointer.
@return The logical sector number of a given Long Allocation Descriptor.
**/
UINT64 UINT64
GetLongAdLsn ( GetLongAdLsn (
IN UDF_VOLUME_INFO *Volume, IN UDF_VOLUME_INFO *Volume,
@ -288,9 +328,15 @@ GetLongAdLsn (
LongAd->ExtentLocation.LogicalBlockNumber; LongAd->ExtentLocation.LogicalBlockNumber;
} }
// /**
// Return logical sector number of a given Short Allocation Descriptor. Return logical sector number of a given Short Allocation Descriptor.
//
@param[in] PartitionDesc Partition Descriptor pointer.
@param[in] ShortAd Short Allocation Descriptor pointer.
@return The logical sector number of a given Short Allocation Descriptor.
**/
UINT64 UINT64
GetShortAdLsn ( GetShortAdLsn (
IN UDF_PARTITION_DESCRIPTOR *PartitionDesc, IN UDF_PARTITION_DESCRIPTOR *PartitionDesc,
@ -303,12 +349,23 @@ GetShortAdLsn (
ShortAd->ExtentPosition; ShortAd->ExtentPosition;
} }
// /**
// Find File Set Descriptor of a given Logical Volume Descriptor. Find File Set Descriptor of a given Logical Volume Descriptor.
//
// The found FSD will contain the extent (LogicalVolumeContentsUse) where our The found FSD will contain the extent (LogicalVolumeContentsUse) where our
// root directory is. root directory is.
//
@param[in] BlockIo BlockIo interface.
@param[in] DiskIo DiskIo interface.
@param[in] Volume Volume information pointer.
@param[in] LogicalVolDescNum Index of Logical Volume Descriptor
@param[out] FileSetDesc File Set Descriptor pointer.
@retval EFI_SUCCESS File Set Descriptor pointer found.
@retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.
@retval other File Set Descriptor pointer not found.
**/
EFI_STATUS EFI_STATUS
FindFileSetDescriptor ( FindFileSetDescriptor (
IN EFI_BLOCK_IO_PROTOCOL *BlockIo, IN EFI_BLOCK_IO_PROTOCOL *BlockIo,
@ -349,9 +406,20 @@ FindFileSetDescriptor (
return EFI_SUCCESS; return EFI_SUCCESS;
} }
// /**
// Get all File Set Descriptors for each Logical Volume Descriptor. Get all File Set Descriptors for each Logical Volume Descriptor.
//
@param[in] BlockIo BlockIo interface.
@param[in] DiskIo DiskIo interface.
@param[in, out] Volume Volume information pointer.
@retval EFI_SUCCESS File Set Descriptors were got.
@retval EFI_OUT_OF_RESOURCES File Set Descriptors were not got due to lack
of resources.
@retval other Error occured when finding File Set
Descriptor in Logical Volume Descriptor.
**/
EFI_STATUS EFI_STATUS
GetFileSetDescriptors ( GetFileSetDescriptors (
IN EFI_BLOCK_IO_PROTOCOL *BlockIo, IN EFI_BLOCK_IO_PROTOCOL *BlockIo,
@ -414,9 +482,17 @@ Error_Alloc_Fsd:
return Status; return Status;
} }
// /**
// Read Volume and File Structure on an UDF file system. Read Volume and File Structure on an UDF file system.
//
@param[in] BlockIo BlockIo interface.
@param[in] DiskIo DiskIo interface.
@param[out] Volume Volume information pointer.
@retval EFI_SUCCESS Volume and File Structure were read.
@retval other Volume and File Structure were not read.
**/
EFI_STATUS EFI_STATUS
ReadVolumeFileStructure ( ReadVolumeFileStructure (
IN EFI_BLOCK_IO_PROTOCOL *BlockIo, IN EFI_BLOCK_IO_PROTOCOL *BlockIo,
@ -455,9 +531,14 @@ ReadVolumeFileStructure (
return Status; return Status;
} }
// /**
// Calculate length of a given File Identifier Descriptor. Calculate length of a given File Identifier Descriptor.
//
@param[in] FileIdentifierDesc File Identifier Descriptor pointer.
@return The length of a given File Identifier Descriptor.
**/
UINT64 UINT64
GetFidDescriptorLength ( GetFidDescriptorLength (
IN UDF_FILE_IDENTIFIER_DESCRIPTOR *FileIdentifierDesc IN UDF_FILE_IDENTIFIER_DESCRIPTOR *FileIdentifierDesc
@ -470,9 +551,13 @@ GetFidDescriptorLength (
); );
} }
// /**
// Duplicate a given File Identifier Descriptor. Duplicate a given File Identifier Descriptor.
//
@param[in] FileIdentifierDesc File Identifier Descriptor pointer.
@param[out] NewFileIdentifierDesc The duplicated File Identifier Descriptor.
**/
VOID VOID
DuplicateFid ( DuplicateFid (
IN UDF_FILE_IDENTIFIER_DESCRIPTOR *FileIdentifierDesc, IN UDF_FILE_IDENTIFIER_DESCRIPTOR *FileIdentifierDesc,
@ -486,9 +571,15 @@ DuplicateFid (
ASSERT (*NewFileIdentifierDesc != NULL); ASSERT (*NewFileIdentifierDesc != NULL);
} }
// /**
// Duplicate either a given File Entry or a given Extended File Entry. Duplicate either a given File Entry or a given Extended File Entry.
//
@param[in] BlockIo BlockIo interface.
@param[in] Volume Volume information pointer.
@param[in] FileEntry (Extended) File Entry pointer.
@param[out] NewFileEntry The duplicated (Extended) File Entry.
**/
VOID VOID
DuplicateFe ( DuplicateFe (
IN EFI_BLOCK_IO_PROTOCOL *BlockIo, IN EFI_BLOCK_IO_PROTOCOL *BlockIo,
@ -502,15 +593,21 @@ DuplicateFe (
ASSERT (*NewFileEntry != NULL); ASSERT (*NewFileEntry != NULL);
} }
// /**
// Get raw data + length of a given File Entry or Extended File Entry. Get raw data + length of a given File Entry or Extended File Entry.
//
// The file's recorded data can contain either real file content (inline) or The file's recorded data can contain either real file content (inline) or
// a sequence of extents (or Allocation Descriptors) which tells where file's a sequence of extents (or Allocation Descriptors) which tells where file's
// content is stored in. content is stored in.
//
// NOTE: The FE/EFE can be thought it was an inode. NOTE: The FE/EFE can be thought it was an inode.
//
@param[in] FileEntryData (Extended) File Entry pointer.
@param[out] Data Buffer contains the raw data of a given
(Extended) File Entry.
@param[out] Length Length of the data in Buffer.
**/
VOID VOID
GetFileEntryData ( GetFileEntryData (
IN VOID *FileEntryData, IN VOID *FileEntryData,
@ -536,9 +633,15 @@ GetFileEntryData (
} }
} }
// /**
// Get Allocation Descriptors' data information from a given FE/EFE. Get Allocation Descriptors' data information from a given FE/EFE.
//
@param[in] FileEntryData (Extended) File Entry pointer.
@param[out] AdsData Buffer contains the Allocation Descriptors'
data from a given FE/EFE.
@param[out] Length Length of the data in AdsData.
**/
VOID VOID
GetAdsInformation ( GetAdsInformation (
IN VOID *FileEntryData, IN VOID *FileEntryData,
@ -564,9 +667,18 @@ GetAdsInformation (
} }
} }
// /**
// Read next Long Allocation Descriptor from a given file's data. Read next Long Allocation Descriptor from a given file's data.
//
@param[in] Data File's data pointer.
@param[in,out] Offset Starting offset of the File's data to read.
@param[in] Length Length of the data to read.
@param[out] FoundLongAd Long Allocation Descriptor pointer.
@retval EFI_SUCCESS A Long Allocation Descriptor was found.
@retval EFI_DEVICE_ERROR No more Long Allocation Descriptors.
**/
EFI_STATUS EFI_STATUS
GetLongAdFromAds ( GetLongAdFromAds (
IN VOID *Data, IN VOID *Data,
@ -611,9 +723,18 @@ GetLongAdFromAds (
return EFI_SUCCESS; return EFI_SUCCESS;
} }
// /**
// Read next Short Allocation Descriptor from a given file's data. Read next Short Allocation Descriptor from a given file's data.
//
@param[in] Data File's data pointer.
@param[in,out] Offset Starting offset of the File's data to read.
@param[in] Length Length of the data to read.
@param[out] FoundShortAd Short Allocation Descriptor pointer.
@retval EFI_SUCCESS A Short Allocation Descriptor was found.
@retval EFI_DEVICE_ERROR No more Short Allocation Descriptors.
**/
EFI_STATUS EFI_STATUS
GetShortAdFromAds ( GetShortAdFromAds (
IN VOID *Data, IN VOID *Data,
@ -658,10 +779,21 @@ GetShortAdFromAds (
return EFI_SUCCESS; return EFI_SUCCESS;
} }
// /**
// Get either a Short Allocation Descriptor or a Long Allocation Descriptor from Get either a Short Allocation Descriptor or a Long Allocation Descriptor from
// file's data. file's data.
//
@param[in] RecordingFlags Flag to indicate the type of descriptor.
@param[in] Data File's data pointer.
@param[in,out] Offset Starting offset of the File's data to read.
@param[in] Length Length of the data to read.
@param[out] FoundAd Allocation Descriptor pointer.
@retval EFI_SUCCESS A Short Allocation Descriptor was found.
@retval EFI_DEVICE_ERROR No more Allocation Descriptors.
Invalid type of descriptor was given.
**/
EFI_STATUS EFI_STATUS
GetAllocationDescriptor ( GetAllocationDescriptor (
IN UDF_FE_RECORDING_FLAGS RecordingFlags, IN UDF_FE_RECORDING_FLAGS RecordingFlags,
@ -690,9 +822,17 @@ GetAllocationDescriptor (
return EFI_DEVICE_ERROR; return EFI_DEVICE_ERROR;
} }
// /**
// Return logical sector number of either Short or Long Allocation Descriptor. Return logical sector number of either Short or Long Allocation Descriptor.
//
@param[in] RecordingFlags Flag to indicate the type of descriptor.
@param[in] Volume Volume information pointer.
@param[in] ParentIcb Long Allocation Descriptor pointer.
@param[in] Ad Allocation Descriptor pointer.
@return The logical sector number of the given Allocation Descriptor.
**/
UINT64 UINT64
GetAllocationDescriptorLsn ( GetAllocationDescriptorLsn (
IN UDF_FE_RECORDING_FLAGS RecordingFlags, IN UDF_FE_RECORDING_FLAGS RecordingFlags,
@ -713,9 +853,27 @@ GetAllocationDescriptorLsn (
return 0; return 0;
} }
// /**
// Return offset + length of a given indirect Allocation Descriptor (AED). Return offset + length of a given indirect Allocation Descriptor (AED).
//
@param[in] BlockIo BlockIo interface.
@param[in] DiskIo DiskIo interface.
@param[in] Volume Volume information pointer.
@param[in] ParentIcb Long Allocation Descriptor pointer.
@param[in] RecordingFlags Flag to indicate the type of descriptor.
@param[in] Ad Allocation Descriptor pointer.
@param[out] Offset Offset of a given indirect Allocation
Descriptor.
@param[out] Length Length of a given indirect Allocation
Descriptor.
@retval EFI_SUCCESS The offset and length were returned.
@retval EFI_OUT_OF_RESOURCES The offset and length were not returned due
to lack of resources.
@retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.
@retval other The offset and length were not returned.
**/
EFI_STATUS EFI_STATUS
GetAedAdsOffset ( GetAedAdsOffset (
IN EFI_BLOCK_IO_PROTOCOL *BlockIo, IN EFI_BLOCK_IO_PROTOCOL *BlockIo,
@ -784,9 +942,25 @@ Exit:
return Status; return Status;
} }
// /**
// Read Allocation Extent Descriptor into memory. Read Allocation Extent Descriptor into memory.
//
@param[in] BlockIo BlockIo interface.
@param[in] DiskIo DiskIo interface.
@param[in] Volume Volume information pointer.
@param[in] ParentIcb Long Allocation Descriptor pointer.
@param[in] RecordingFlags Flag to indicate the type of descriptor.
@param[in] Ad Allocation Descriptor pointer.
@param[out] Data Buffer that contains the Allocation Extent
Descriptor.
@param[out] Length Length of Data.
@retval EFI_SUCCESS The Allocation Extent Descriptor was read.
@retval EFI_OUT_OF_RESOURCES The Allocation Extent Descriptor was not read
due to lack of resources.
@retval other Fail to read the disk.
**/
EFI_STATUS EFI_STATUS
GetAedAdsData ( GetAedAdsData (
IN EFI_BLOCK_IO_PROTOCOL *BlockIo, IN EFI_BLOCK_IO_PROTOCOL *BlockIo,
@ -836,9 +1010,19 @@ GetAedAdsData (
); );
} }
// /**
// Function used to serialise reads of Allocation Descriptors. Function used to serialise reads of Allocation Descriptors.
//
@param[in] RecordingFlags Flag to indicate the type of descriptor.
@param[in] Ad Allocation Descriptor pointer.
@param[in, out] Buffer Buffer to hold the next Allocation Descriptor.
@param[in] Length Length of Buffer.
@retval EFI_SUCCESS Buffer was grown to hold the next Allocation
Descriptor.
@retval EFI_OUT_OF_RESOURCES Buffer was not grown due to lack of resources.
**/
EFI_STATUS EFI_STATUS
GrowUpBufferToNextAd ( GrowUpBufferToNextAd (
IN UDF_FE_RECORDING_FLAGS RecordingFlags, IN UDF_FE_RECORDING_FLAGS RecordingFlags,
@ -866,9 +1050,26 @@ GrowUpBufferToNextAd (
return EFI_SUCCESS; return EFI_SUCCESS;
} }
// /**
// Read data or size of either a File Entry or an Extended File Entry. Read data or size of either a File Entry or an Extended File Entry.
//
@param[in] BlockIo BlockIo interface.
@param[in] DiskIo DiskIo interface.
@param[in] Volume Volume information pointer.
@param[in] ParentIcb Long Allocation Descriptor pointer.
@param[in] FileEntryData FE/EFE structure pointer.
@param[in, out] ReadFileInfo Read file information pointer.
@retval EFI_SUCCESS Data or size of a FE/EFE was read.
@retval EFI_OUT_OF_RESOURCES Data or size of a FE/EFE was not read due to
lack of resources.
@retval EFI_INVALID_PARAMETER The read file flag given in ReadFileInfo is
invalid.
@retval EFI_UNSUPPORTED The FE recording flag given in FileEntryData
is not supported.
@retval other Data or size of a FE/EFE was not read.
**/
EFI_STATUS EFI_STATUS
ReadFile ( ReadFile (
IN EFI_BLOCK_IO_PROTOCOL *BlockIo, IN EFI_BLOCK_IO_PROTOCOL *BlockIo,
@ -1194,9 +1395,22 @@ Error_Get_Aed:
return Status; return Status;
} }
// /**
// Find a file by its filename from a given Parent file. Find a file by its filename from a given Parent file.
//
@param[in] BlockIo BlockIo interface.
@param[in] DiskIo DiskIo interface.
@param[in] Volume Volume information pointer.
@param[in] FileName File name string.
@param[in] Parent Parent directory file.
@param[in] Icb Long Allocation Descriptor pointer.
@param[out] File Found file.
@retval EFI_SUCCESS The file was found.
@retval EFI_INVALID_PARAMETER One or more input parameters are invalid.
@retval EFI_NOT_FOUND The file was not found.
**/
EFI_STATUS EFI_STATUS
InternalFindFile ( InternalFindFile (
IN EFI_BLOCK_IO_PROTOCOL *BlockIo, IN EFI_BLOCK_IO_PROTOCOL *BlockIo,
@ -1531,13 +1745,14 @@ Error_Read_Disk_Blk:
@param[in] FilePath File's absolute path. @param[in] FilePath File's absolute path.
@param[in] Root Root directory file. @param[in] Root Root directory file.
@param[in] Parent Parent directory file. @param[in] Parent Parent directory file.
@param[in] Icb ICB of Parent.
@param[out] File Found file. @param[out] File Found file.
@retval EFI_SUCCESS @p FilePath was found. @retval EFI_SUCCESS FilePath was found.
@retval EFI_NO_MEDIA The device has no media. @retval EFI_NO_MEDIA The device has no media.
@retval EFI_DEVICE_ERROR The device reported an error. @retval EFI_DEVICE_ERROR The device reported an error.
@retval EFI_VOLUME_CORRUPTED The file system structures are corrupted. @retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.
@retval EFI_OUT_OF_RESOURCES The @p FilePath file was not found due to lack of @retval EFI_OUT_OF_RESOURCES The FilePath file was not found due to lack of
resources. resources.
**/ **/
@ -1658,7 +1873,7 @@ FindFile (
@param[in] Volume UDF volume information structure. @param[in] Volume UDF volume information structure.
@param[in] ParentIcb ICB of the parent file. @param[in] ParentIcb ICB of the parent file.
@param[in] FileEntryData FE/EFE of the parent file. @param[in] FileEntryData FE/EFE of the parent file.
@param[in out] ReadDirInfo Next read directory listing structure @param[in, out] ReadDirInfo Next read directory listing structure
information. information.
@param[out] FoundFid File Identifier Descriptor pointer. @param[out] FoundFid File Identifier Descriptor pointer.
@ -2043,7 +2258,7 @@ CleanupFileInformation (
@param[in] File File information structure. @param[in] File File information structure.
@param[out] Size Size of the file. @param[out] Size Size of the file.
@retval EFI_SUCCESS File size calculated and set in @p Size. @retval EFI_SUCCESS File size calculated and set in Size.
@retval EFI_UNSUPPORTED Extended Allocation Descriptors not supported. @retval EFI_UNSUPPORTED Extended Allocation Descriptors not supported.
@retval EFI_NO_MEDIA The device has no media. @retval EFI_NO_MEDIA The device has no media.
@retval EFI_DEVICE_ERROR The device reported an error. @retval EFI_DEVICE_ERROR The device reported an error.
@ -2089,7 +2304,7 @@ GetFileSize (
@param[in] File File pointer. @param[in] File File pointer.
@param[in] FileSize Size of the file. @param[in] FileSize Size of the file.
@param[in] FileName Filename of the file. @param[in] FileName Filename of the file.
@param[in out] BufferSize Size of the returned file infomation. @param[in, out] BufferSize Size of the returned file infomation.
@param[out] Buffer Data of the returned file information. @param[out] Buffer Data of the returned file information.
@retval EFI_SUCCESS File information set. @retval EFI_SUCCESS File information set.
@ -2362,9 +2577,9 @@ GetVolumeSize (
@param[in] Volume UDF volume information structure. @param[in] Volume UDF volume information structure.
@param[in] File File information structure. @param[in] File File information structure.
@param[in] FileSize Size of the file. @param[in] FileSize Size of the file.
@param[in out] FilePosition File position. @param[in, out] FilePosition File position.
@param[in out] Buffer File data. @param[in, out] Buffer File data.
@param[in out] BufferSize Read size. @param[in, out] BufferSize Read size.
@retval EFI_SUCCESS File seeked and read. @retval EFI_SUCCESS File seeked and read.
@retval EFI_UNSUPPORTED Extended Allocation Descriptors not supported. @retval EFI_UNSUPPORTED Extended Allocation Descriptors not supported.

View File

@ -659,7 +659,7 @@ UdfGetInfo (
/** /**
Set information about a file. Set information about a file.
@param File Protocol instance pointer. @param This Protocol instance pointer.
@param InformationType Type of information in Buffer. @param InformationType Type of information in Buffer.
@param BufferSize Size of buffer. @param BufferSize Size of buffer.
@param Buffer The data to write. @param Buffer The data to write.
@ -783,13 +783,14 @@ FindFileEntry (
@param[in] FilePath File's absolute path. @param[in] FilePath File's absolute path.
@param[in] Root Root directory file. @param[in] Root Root directory file.
@param[in] Parent Parent directory file. @param[in] Parent Parent directory file.
@param[in] Icb ICB of Parent.
@param[out] File Found file. @param[out] File Found file.
@retval EFI_SUCCESS @p FilePath was found. @retval EFI_SUCCESS FilePath was found.
@retval EFI_NO_MEDIA The device has no media. @retval EFI_NO_MEDIA The device has no media.
@retval EFI_DEVICE_ERROR The device reported an error. @retval EFI_DEVICE_ERROR The device reported an error.
@retval EFI_VOLUME_CORRUPTED The file system structures are corrupted. @retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.
@retval EFI_OUT_OF_RESOURCES The @p FilePath file was not found due to lack of @retval EFI_OUT_OF_RESOURCES The FilePath file was not found due to lack of
resources. resources.
**/ **/
@ -813,7 +814,7 @@ FindFile (
@param[in] Volume UDF volume information structure. @param[in] Volume UDF volume information structure.
@param[in] ParentIcb ICB of the parent file. @param[in] ParentIcb ICB of the parent file.
@param[in] FileEntryData FE/EFE of the parent file. @param[in] FileEntryData FE/EFE of the parent file.
@param[in out] ReadDirInfo Next read directory listing structure @param[in, out] ReadDirInfo Next read directory listing structure
information. information.
@param[out] FoundFid File Identifier Descriptor pointer. @param[out] FoundFid File Identifier Descriptor pointer.
@ -913,7 +914,7 @@ CleanupFileInformation (
@param[in] File File information structure. @param[in] File File information structure.
@param[out] Size Size of the file. @param[out] Size Size of the file.
@retval EFI_SUCCESS File size calculated and set in @p Size. @retval EFI_SUCCESS File size calculated and set in Size.
@retval EFI_UNSUPPORTED Extended Allocation Descriptors not supported. @retval EFI_UNSUPPORTED Extended Allocation Descriptors not supported.
@retval EFI_NO_MEDIA The device has no media. @retval EFI_NO_MEDIA The device has no media.
@retval EFI_DEVICE_ERROR The device reported an error. @retval EFI_DEVICE_ERROR The device reported an error.
@ -937,7 +938,7 @@ GetFileSize (
@param[in] File File pointer. @param[in] File File pointer.
@param[in] FileSize Size of the file. @param[in] FileSize Size of the file.
@param[in] FileName Filename of the file. @param[in] FileName Filename of the file.
@param[in out] BufferSize Size of the returned file infomation. @param[in, out] BufferSize Size of the returned file infomation.
@param[out] Buffer Data of the returned file information. @param[out] Buffer Data of the returned file information.
@retval EFI_SUCCESS File information set. @retval EFI_SUCCESS File information set.
@ -991,9 +992,9 @@ GetVolumeSize (
@param[in] Volume UDF volume information structure. @param[in] Volume UDF volume information structure.
@param[in] File File information structure. @param[in] File File information structure.
@param[in] FileSize Size of the file. @param[in] FileSize Size of the file.
@param[in out] FilePosition File position. @param[in, out] FilePosition File position.
@param[in out] Buffer File data. @param[in, out] Buffer File data.
@param[in out] BufferSize Read size. @param[in, out] BufferSize Read size.
@retval EFI_SUCCESS File seeked and read. @retval EFI_SUCCESS File seeked and read.
@retval EFI_UNSUPPORTED Extended Allocation Descriptors not supported. @retval EFI_UNSUPPORTED Extended Allocation Descriptors not supported.
@ -1037,7 +1038,7 @@ SupportUdfFileSystem (
@param[in] FileName Filename. @param[in] FileName Filename.
@retval @p FileName Filename mangled. @retval The mangled Filename.
**/ **/
CHAR16 * CHAR16 *