diff options
Diffstat (limited to 'FatPkg/EnhancedFatDxe/Open.c')
| -rw-r--r-- | FatPkg/EnhancedFatDxe/Open.c | 172 |
1 files changed, 71 insertions, 101 deletions
diff --git a/FatPkg/EnhancedFatDxe/Open.c b/FatPkg/EnhancedFatDxe/Open.c index 1d864d1248..7b273fe1b1 100644 --- a/FatPkg/EnhancedFatDxe/Open.c +++ b/FatPkg/EnhancedFatDxe/Open.c @@ -1,4 +1,5 @@ -/*++
+/** @file
+ Routines dealing with file open.
Copyright (c) 2005 - 2014, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials are licensed and made available
@@ -9,44 +10,27 @@ http://opensource.org/licenses/bsd-license.php THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+**/
-Module Name:
-
- open.c
+#include "Fat.h"
-Abstract:
+/**
- Routines dealing with file open
+ Create an Open instance for the existing OFile.
+ The IFile of the newly opened file is passed out.
-Revision History
+ @param OFile - The file that serves as a starting reference point.
+ @param PtrIFile - The newly generated IFile instance.
---*/
-
-#include "Fat.h"
+ @retval EFI_OUT_OF_RESOURCES - Can not allocate the memory for the IFile
+ @retval EFI_SUCCESS - Create the new IFile for the OFile successfully
+**/
EFI_STATUS
FatAllocateIFile (
IN FAT_OFILE *OFile,
OUT FAT_IFILE **PtrIFile
)
-/*++
-
-Routine Description:
-
- Create an Open instance for the existing OFile.
- The IFile of the newly opened file is passed out.
-
-Arguments:
-
- OFile - The file that serves as a starting reference point.
- PtrIFile - The newly generated IFile instance.
-
-Returns:
-
- EFI_OUT_OF_RESOURCES - Can not allocate the memory for the IFile
- EFI_SUCCESS - Create the new IFile for the OFile successfully
-
---*/
{
FAT_IFILE *IFile;
@@ -81,41 +65,36 @@ Returns: return EFI_SUCCESS;
}
-EFI_STATUS
-FatOFileOpen (
- IN FAT_OFILE *OFile,
- OUT FAT_IFILE **NewIFile,
- IN CHAR16 *FileName,
- IN UINT64 OpenMode,
- IN UINT8 Attributes
- )
-/*++
-
-Routine Description:
+/**
Open a file for a file name relative to an existing OFile.
The IFile of the newly opened file is passed out.
-Arguments:
-
- OFile - The file that serves as a starting reference point.
- NewIFile - The newly generated IFile instance.
- FileName - The file name relative to the OFile.
- OpenMode - Open mode.
- Attributes - Attributes to set if the file is created.
+ @param OFile - The file that serves as a starting reference point.
+ @param NewIFile - The newly generated IFile instance.
+ @param FileName - The file name relative to the OFile.
+ @param OpenMode - Open mode.
+ @param Attributes - Attributes to set if the file is created.
-Returns:
- EFI_SUCCESS - Open the file successfully.
- EFI_INVALID_PARAMETER - The open mode is conflict with the attributes
+ @retval EFI_SUCCESS - Open the file successfully.
+ @retval EFI_INVALID_PARAMETER - The open mode is conflict with the attributes
or the file name is not valid.
- EFI_NOT_FOUND - Conficts between dir intention and attribute.
- EFI_WRITE_PROTECTED - Can't open for write if the volume is read only.
- EFI_ACCESS_DENIED - If the file's attribute is read only, and the
+ @retval EFI_NOT_FOUND - Conficts between dir intention and attribute.
+ @retval EFI_WRITE_PROTECTED - Can't open for write if the volume is read only.
+ @retval EFI_ACCESS_DENIED - If the file's attribute is read only, and the
open is for read-write fail it.
- EFI_OUT_OF_RESOURCES - Can not allocate the memory.
+ @retval EFI_OUT_OF_RESOURCES - Can not allocate the memory.
---*/
+**/
+EFI_STATUS
+FatOFileOpen (
+ IN FAT_OFILE *OFile,
+ OUT FAT_IFILE **NewIFile,
+ IN CHAR16 *FileName,
+ IN UINT64 OpenMode,
+ IN UINT8 Attributes
+ )
{
FAT_VOLUME *Volume;
EFI_STATUS Status;
@@ -199,6 +178,25 @@ Returns: return FatOFileFlush (OFile);
}
+/**
+
+ Implements OpenEx() of Simple File System Protocol.
+
+ @param FHand - File handle of the file serves as a starting reference point.
+ @param NewHandle - Handle of the file that is newly opened.
+ @param FileName - File name relative to FHand.
+ @param OpenMode - Open mode.
+ @param Attributes - Attributes to set if the file is created.
+ @param Token - A pointer to the token associated with the transaction.:
+
+ @retval EFI_INVALID_PARAMETER - The FileName is NULL or the file string is empty.
+ The OpenMode is not supported.
+ The Attributes is not the valid attributes.
+ @retval EFI_OUT_OF_RESOURCES - Can not allocate the memory for file string.
+ @retval EFI_SUCCESS - Open the file successfully.
+ @return Others - The status of open file.
+
+**/
EFI_STATUS
EFIAPI
FatOpenEx (
@@ -209,30 +207,6 @@ FatOpenEx ( IN UINT64 Attributes,
IN OUT EFI_FILE_IO_TOKEN *Token
)
-/*++
-Routine Description:
-
- Implements OpenEx() of Simple File System Protocol.
-
-Arguments:
-
- FHand - File handle of the file serves as a starting reference point.
- NewHandle - Handle of the file that is newly opened.
- FileName - File name relative to FHand.
- OpenMode - Open mode.
- Attributes - Attributes to set if the file is created.
- Token - A pointer to the token associated with the transaction.
-
-Returns:
-
- EFI_INVALID_PARAMETER - The FileName is NULL or the file string is empty.
- The OpenMode is not supported.
- The Attributes is not the valid attributes.
- EFI_OUT_OF_RESOURCES - Can not allocate the memory for file string.
- EFI_SUCCESS - Open the file successfully.
- Others - The status of open file.
-
---*/
{
FAT_IFILE *IFile;
FAT_IFILE *NewIFile;
@@ -319,6 +293,25 @@ Returns: return Status;
}
+/**
+
+ Implements Open() of Simple File System Protocol.
+
+
+ @param FHand - File handle of the file serves as a starting reference point.
+ @param NewHandle - Handle of the file that is newly opened.
+ @param FileName - File name relative to FHand.
+ @param OpenMode - Open mode.
+ @param Attributes - Attributes to set if the file is created.
+
+ @retval EFI_INVALID_PARAMETER - The FileName is NULL or the file string is empty.
+ The OpenMode is not supported.
+ The Attributes is not the valid attributes.
+ @retval EFI_OUT_OF_RESOURCES - Can not allocate the memory for file string.
+ @retval EFI_SUCCESS - Open the file successfully.
+ @return Others - The status of open file.
+
+**/
EFI_STATUS
EFIAPI
FatOpen (
@@ -328,29 +321,6 @@ FatOpen ( IN UINT64 OpenMode,
IN UINT64 Attributes
)
-/*++
-Routine Description:
-
- Implements Open() of Simple File System Protocol.
-
-Arguments:
-
- FHand - File handle of the file serves as a starting reference point.
- NewHandle - Handle of the file that is newly opened.
- FileName - File name relative to FHand.
- OpenMode - Open mode.
- Attributes - Attributes to set if the file is created.
-
-Returns:
-
- EFI_INVALID_PARAMETER - The FileName is NULL or the file string is empty.
- The OpenMode is not supported.
- The Attributes is not the valid attributes.
- EFI_OUT_OF_RESOURCES - Can not allocate the memory for file string.
- EFI_SUCCESS - Open the file successfully.
- Others - The status of open file.
-
---*/
{
return FatOpenEx (FHand, NewHandle, FileName, OpenMode, Attributes, NULL);
}
|