]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Include/Protocol/SimpleFileSystem.h
code scrub ArpDxe
[mirror_edk2.git] / MdePkg / Include / Protocol / SimpleFileSystem.h
index f6095c7c165ce854b7e86a32cf52b3ad1fc5bba2..ddfbebb80c598bdb97a5fdc36b1dfd9fbd02fe1e 100644 (file)
@@ -1,13 +1,13 @@
 /** @file\r
-  SimpleFileSystem protocol as defined in the EFI 1.0 specification.\r
+  SimpleFileSystem protocol as defined in the UEFI 2.0 specification.\r
 \r
   The SimpleFileSystem protocol is the programatic access to the FAT (12,16,32) \r
-  file system specified in EFI 1.0. It can also be used to abstract a file  \r
+  file system specified in UEFI 2.0. It can also be used to abstract a file  \r
   system other than FAT.\r
 \r
-  EFI 1.0 can boot from any valid EFI image contained in a SimpleFileSystem\r
+  UEFI 2.0 can boot from any valid EFI image contained in a SimpleFileSystem\r
 \r
-  Copyright (c) 2006, Intel Corporation                                                         \r
+  Copyright (c) 2006 - 2008, Intel Corporation                                                         \r
   All rights reserved. This program and the accompanying materials                          \r
   are licensed and made available under the terms and conditions of the BSD License         \r
   which accompanies this distribution.  The full text of the license may be found at        \r
@@ -16,8 +16,6 @@
   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
 \r
-  Module Name:  SimpleFileSystem.h\r
-\r
 **/\r
 \r
 #ifndef __SIMPLE_FILE_SYSTEM_H__\r
@@ -33,15 +31,14 @@ typedef struct _EFI_SIMPLE_FILE_SYSTEM_PROTOCOL  EFI_SIMPLE_FILE_SYSTEM_PROTOCOL
 typedef struct _EFI_FILE_PROTOCOL         EFI_FILE_PROTOCOL;\r
 typedef struct _EFI_FILE_PROTOCOL         *EFI_FILE_HANDLE;\r
 \r
-\r
-//\r
-// Protocol GUID defined in EFI1.1.\r
-// \r
+///\r
+/// Protocol GUID name defined in EFI1.1.\r
+/// \r
 #define SIMPLE_FILE_SYSTEM_PROTOCOL       EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_GUID\r
 \r
-//\r
-// Protocol defined in EFI1.1.\r
-// \r
+///\r
+/// Protocol name defined in EFI1.1.\r
+/// \r
 typedef EFI_SIMPLE_FILE_SYSTEM_PROTOCOL   EFI_FILE_IO_INTERFACE;\r
 typedef struct _EFI_FILE_PROTOCOL         EFI_FILE;\r
 \r
@@ -62,19 +59,24 @@ typedef struct _EFI_FILE_PROTOCOL         EFI_FILE;
 **/\r
 typedef\r
 EFI_STATUS\r
-(EFIAPI *EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_OPEN_VOLUME) (\r
+(EFIAPI *EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_OPEN_VOLUME)(\r
   IN EFI_SIMPLE_FILE_SYSTEM_PROTOCOL    *This,\r
   OUT EFI_FILE_PROTOCOL                 **Root\r
-  )\r
-;\r
+  );\r
 \r
 #define EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_REVISION  0x00010000\r
-//\r
-// Revision defined in EFI1.1\r
-// \r
+\r
+///\r
+/// Revision defined in EFI1.1\r
+/// \r
 #define EFI_FILE_IO_INTERFACE_REVISION  EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_REVISION\r
 \r
 struct _EFI_SIMPLE_FILE_SYSTEM_PROTOCOL {\r
+  ///\r
+  /// The version of the EFI_SIMPLE_FILE_SYSTEM_PROTOCOL. The version\r
+  /// specified by this specification is 0x00010000. All future revisions\r
+  /// must be backwards compatible.\r
+  ///\r
   UINT64                                      Revision;\r
   EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_OPEN_VOLUME OpenVolume;\r
 };\r
@@ -101,14 +103,13 @@ struct _EFI_SIMPLE_FILE_SYSTEM_PROTOCOL {
 **/\r
 typedef\r
 EFI_STATUS\r
-(EFIAPI *EFI_FILE_OPEN) (\r
+(EFIAPI *EFI_FILE_OPEN)(\r
   IN EFI_FILE_PROTOCOL        *This,\r
   OUT EFI_FILE_PROTOCOL       **NewHandle,\r
   IN CHAR16                   *FileName,\r
   IN UINT64                   OpenMode,\r
   IN UINT64                   Attributes\r
-  )\r
-;\r
+  );\r
 \r
 //\r
 // Open modes\r
@@ -138,10 +139,9 @@ EFI_STATUS
 **/\r
 typedef\r
 EFI_STATUS\r
-(EFIAPI *EFI_FILE_CLOSE) (\r
+(EFIAPI *EFI_FILE_CLOSE)(\r
   IN EFI_FILE  *This\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Close and delete the file handle\r
@@ -154,10 +154,9 @@ EFI_STATUS
 **/\r
 typedef\r
 EFI_STATUS\r
-(EFIAPI *EFI_FILE_DELETE) (\r
+(EFIAPI *EFI_FILE_DELETE)(\r
   IN EFI_FILE  *This\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Read data from the file.\r
@@ -175,12 +174,11 @@ EFI_STATUS
 **/\r
 typedef\r
 EFI_STATUS\r
-(EFIAPI *EFI_FILE_READ) (\r
+(EFIAPI *EFI_FILE_READ)(\r
   IN EFI_FILE_PROTOCOL        *This,\r
   IN OUT UINTN                *BufferSize,\r
   OUT VOID                    *Buffer\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Write data from to the file.\r
@@ -201,12 +199,11 @@ EFI_STATUS
 **/\r
 typedef\r
 EFI_STATUS\r
-(EFIAPI *EFI_FILE_WRITE) (\r
+(EFIAPI *EFI_FILE_WRITE)(\r
   IN EFI_FILE_PROTOCOL        *This,\r
   IN OUT UINTN                *BufferSize,\r
   IN VOID                     *Buffer\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Set a files current position\r
@@ -220,11 +217,10 @@ EFI_STATUS
 **/\r
 typedef\r
 EFI_STATUS\r
-(EFIAPI *EFI_FILE_SET_POSITION) (\r
+(EFIAPI *EFI_FILE_SET_POSITION)(\r
   IN EFI_FILE_PROTOCOL        *This,\r
   IN UINT64                   Position\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Get a files current position\r
@@ -238,11 +234,10 @@ EFI_STATUS
 **/\r
 typedef\r
 EFI_STATUS\r
-(EFIAPI *EFI_FILE_GET_POSITION) (\r
+(EFIAPI *EFI_FILE_GET_POSITION)(\r
   IN EFI_FILE_PROTOCOL        *This,\r
   OUT UINT64                  *Position\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Get information about a file\r
@@ -264,13 +259,12 @@ EFI_STATUS
 **/\r
 typedef\r
 EFI_STATUS\r
-(EFIAPI *EFI_FILE_GET_INFO) (\r
+(EFIAPI *EFI_FILE_GET_INFO)(\r
   IN EFI_FILE_PROTOCOL        *This,\r
   IN EFI_GUID                 *InformationType,\r
   IN OUT UINTN                *BufferSize,\r
   OUT VOID                    *Buffer\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Set information about a file\r
@@ -291,13 +285,12 @@ EFI_STATUS
 **/\r
 typedef\r
 EFI_STATUS\r
-(EFIAPI *EFI_FILE_SET_INFO) (\r
+(EFIAPI *EFI_FILE_SET_INFO)(\r
   IN EFI_FILE_PROTOCOL        *This,\r
   IN EFI_GUID                 *InformationType,\r
   IN UINTN                    BufferSize,\r
   IN VOID                     *Buffer\r
-  )\r
-;\r
+  );\r
 \r
 /**\r
   Flush data back for the file handle\r
@@ -316,10 +309,9 @@ EFI_STATUS
 **/\r
 typedef\r
 EFI_STATUS\r
-(EFIAPI *EFI_FILE_FLUSH) (\r
+(EFIAPI *EFI_FILE_FLUSH)(\r
   IN EFI_FILE  *This\r
-  )\r
-;\r
+  );\r
 \r
 #define EFI_FILE_PROTOCOL_REVISION   0x00010000\r
 //\r
@@ -327,7 +319,19 @@ EFI_STATUS
 // \r
 #define EFI_FILE_REVISION   EFI_FILE_PROTOCOL_REVISION\r
 \r
+///\r
+/// The EFI_FILE_PROTOCOL provides file IO access to supported file systems.\r
+/// An EFI_FILE_PROTOCOL provides access to a file's or directory's contents, \r
+/// and is also a reference to a location in the directory tree of the file system \r
+/// in which the file resides. With any given file handle, other files may be opened \r
+/// relative to this file's location, yielding new file handles.\r
+///\r
 struct _EFI_FILE_PROTOCOL {\r
+  ///\r
+  /// The version of the EFI_FILE_PROTOCOL interface. The version specified \r
+  /// by this specification is 0x00010000. Future versions are required \r
+  /// to be backward compatible to version 1.0.\r
+  ///\r
   UINT64                Revision;\r
   EFI_FILE_OPEN         Open;\r
   EFI_FILE_CLOSE        Close;\r