Code Scrub for header files in MdePkg/Include/Ppi and Uefi directory.

[mirror_edk2.git] / MdePkg / Include / Ppi / CpuIo.h

diff --git a/MdePkg/Include/Ppi/CpuIo.h b/MdePkg/Include/Ppi/CpuIo.h
index d34c38d5e08afd70830e636838390aa5e6e2d1a7..1cc6e989ba5c7039dbca800deb70590694e28055 100644 (file)
--- a/MdePkg/Include/Ppi/CpuIo.h
+++ b/MdePkg/Include/Ppi/CpuIo.h
@@ -1,7 +1,8 @@
 /** @file\r
-  This file declares CPU IO PPI that abstracts CPU IO access\r
+  This PPI provides a set of memory- and I/O-based services. \r
+  The perspective of the services is that of the processor, not the bus or system.\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
@@ -19,6 +20,9 @@
 #ifndef __PEI_CPUIO_PPI_H__\r
 #define __PEI_CPUIO_PPI_H__\r
 \r
+#include <ProcessorBind.h>\r
+#include <Pi/PiPeiCis.h>\r
+\r
 #define EFI_PEI_CPU_IO_PPI_INSTALLED_GUID \\r
   { 0xe6af1f7b, 0xfc3f, 0x46da, {0xa8, 0x28, 0xa3, 0xb4, 0x57, 0xa4, 0x42, 0x82 } }\r
 \r
@@ -61,7 +65,7 @@ typedef enum {
 **/\r
 typedef\r
 EFI_STATUS\r
-(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_MEM) (\r
+(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_MEM)(\r
   IN  EFI_PEI_SERVICES                  **PeiServices,\r
   IN  EFI_PEI_CPU_IO_PPI                *This,\r
   IN  EFI_PEI_CPU_IO_PPI_WIDTH          Width,\r
@@ -87,12 +91,12 @@ typedef struct {
   @param  This           Pointer to local data for the interface.\r
   @param  Address        The physical address of the access.\r
 \r
-  @return UINT8\r
+  @return UINT8          An 8-bit value is returned from the I/O space.\r
 \r
 **/\r
 typedef\r
 UINT8\r
-(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_READ8) (\r
+(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_READ8)(\r
   IN  EFI_PEI_SERVICES        **PeiServices,\r
   IN  EFI_PEI_CPU_IO_PPI      *This,\r
   IN  UINT64                  Address\r
@@ -105,12 +109,12 @@ UINT8
   @param  This           Pointer to local data for the interface.\r
   @param  Address        The physical address of the access.\r
 \r
-  @return UINT16\r
+  @return UINT16         A 16-bit value is returned from the I/O space.\r
 \r
 **/\r
 typedef\r
 UINT16\r
-(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_READ16) (\r
+(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_READ16)(\r
   IN  EFI_PEI_SERVICES        **PeiServices,\r
   IN  EFI_PEI_CPU_IO_PPI      *This,\r
   IN  UINT64                  Address\r
@@ -123,12 +127,12 @@ UINT16
   @param  This           Pointer to local data for the interface.\r
   @param  Address        The physical address of the access.\r
 \r
-  @return UINT32\r
+  @return UINT32         A 32-bit value is returned from the I/O space.\r
 \r
 **/\r
 typedef\r
 UINT32\r
-(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_READ32) (\r
+(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_READ32)(\r
   IN  EFI_PEI_SERVICES        **PeiServices,\r
   IN  EFI_PEI_CPU_IO_PPI      *This,\r
   IN  UINT64                  Address\r
@@ -141,12 +145,12 @@ UINT32
   @param  This           Pointer to local data for the interface.\r
   @param  Address        The physical address of the access.\r
 \r
-  @return UINT64\r
+  @return UINT64         A 64-bit value is returned from the I/O space.\r
 \r
 **/\r
 typedef\r
 UINT64\r
-(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_READ64) (\r
+(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_READ64)(\r
   IN  EFI_PEI_SERVICES        **PeiServices,\r
   IN  EFI_PEI_CPU_IO_PPI      *This,\r
   IN  UINT64                  Address\r
@@ -165,7 +169,7 @@ UINT64
 **/\r
 typedef\r
 VOID\r
-(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_WRITE8) (\r
+(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_WRITE8)(\r
   IN  EFI_PEI_SERVICES        **PeiServices,\r
   IN  EFI_PEI_CPU_IO_PPI      *This,\r
   IN  UINT64                  Address,\r
@@ -185,7 +189,7 @@ VOID
 **/\r
 typedef\r
 VOID\r
-(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_WRITE16) (\r
+(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_WRITE16)(\r
   IN  EFI_PEI_SERVICES        **PeiServices,\r
   IN  EFI_PEI_CPU_IO_PPI      *This,\r
   IN  UINT64                  Address,\r
@@ -205,7 +209,7 @@ VOID
 **/\r
 typedef\r
 VOID\r
-(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_WRITE32) (\r
+(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_WRITE32)(\r
   IN  EFI_PEI_SERVICES        **PeiServices,\r
   IN  EFI_PEI_CPU_IO_PPI      *This,\r
   IN  UINT64                  Address,\r
@@ -225,7 +229,7 @@ VOID
 **/\r
 typedef\r
 VOID\r
-(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_WRITE64) (\r
+(EFIAPI *EFI_PEI_CPU_IO_PPI_IO_WRITE64)(\r
   IN  EFI_PEI_SERVICES        **PeiServices,\r
   IN  EFI_PEI_CPU_IO_PPI      *This,\r
   IN  UINT64                  Address,\r
@@ -239,12 +243,12 @@ VOID
   @param  This           Pointer to local data for the interface.\r
   @param  Address        The physical address of the access.\r
 \r
-  @return UINT8\r
+  @return UINT8          An 8-bit value is returned from the memory space.\r
 \r
 **/\r
 typedef\r
 UINT8\r
-(EFIAPI *EFI_PEI_CPU_IO_PPI_MEM_READ8) (\r
+(EFIAPI *EFI_PEI_CPU_IO_PPI_MEM_READ8)(\r
   IN  EFI_PEI_SERVICES        **PeiServices,\r
   IN  EFI_PEI_CPU_IO_PPI      *This,\r
   IN  UINT64                  Address\r
@@ -257,12 +261,12 @@ UINT8
   @param  This           Pointer to local data for the interface.\r
   @param  Address        The physical address of the access.\r
 \r
-  @return UINT16\r
+  @return UINT16         A 16-bit value is returned from the memory space.\r
 \r
 **/\r
 typedef\r
 UINT16\r
-(EFIAPI *EFI_PEI_CPU_IO_PPI_MEM_READ16) (\r
+(EFIAPI *EFI_PEI_CPU_IO_PPI_MEM_READ16)(\r
   IN  EFI_PEI_SERVICES        **PeiServices,\r
   IN  EFI_PEI_CPU_IO_PPI      *This,\r
   IN  UINT64                  Address\r
@@ -275,12 +279,12 @@ UINT16
   @param  This           Pointer to local data for the interface.\r
   @param  Address        The physical address of the access.\r
 \r
-  @return UINT32\r
+  @return UINT32         A 32-bit value is returned from the memory space.\r
 \r
 **/\r
 typedef\r
 UINT32\r
-(EFIAPI *EFI_PEI_CPU_IO_PPI_MEM_READ32) (\r
+(EFIAPI *EFI_PEI_CPU_IO_PPI_MEM_READ32)(\r
   IN  EFI_PEI_SERVICES        **PeiServices,\r
   IN  EFI_PEI_CPU_IO_PPI      *This,\r
   IN  UINT64                  Address\r
@@ -293,12 +297,12 @@ UINT32
   @param  This           Pointer to local data for the interface.\r
   @param  Address        The physical address of the access.\r
 \r
-  @return UINT64\r
+  @return UINT64         A 64-bit value is returned from the memory space.\r
 \r
 **/\r
 typedef\r
 UINT64\r
-(EFIAPI *EFI_PEI_CPU_IO_PPI_MEM_READ64) (\r
+(EFIAPI *EFI_PEI_CPU_IO_PPI_MEM_READ64)(\r
   IN  EFI_PEI_SERVICES        **PeiServices,\r
   IN  EFI_PEI_CPU_IO_PPI      *This,\r
   IN  UINT64                  Address\r
@@ -317,7 +321,7 @@ UINT64
 **/\r
 typedef\r
 VOID\r
-(EFIAPI *EFI_PEI_CPU_IO_PPI_MEM_WRITE8) (\r
+(EFIAPI *EFI_PEI_CPU_IO_PPI_MEM_WRITE8)(\r
   IN  EFI_PEI_SERVICES        **PeiServices,\r
   IN  EFI_PEI_CPU_IO_PPI      *This,\r
   IN  UINT64                  Address,\r
@@ -337,7 +341,7 @@ VOID
 **/\r
 typedef\r
 VOID\r
-(EFIAPI *EFI_PEI_CPU_IO_PPI_MEM_WRITE16) (\r
+(EFIAPI *EFI_PEI_CPU_IO_PPI_MEM_WRITE16)(\r
   IN  EFI_PEI_SERVICES        **PeiServices,\r
   IN  EFI_PEI_CPU_IO_PPI      *This,\r
   IN  UINT64                  Address,\r
@@ -357,7 +361,7 @@ VOID
 **/\r
 typedef\r
 VOID\r
-(EFIAPI *EFI_PEI_CPU_IO_PPI_MEM_WRITE32) (\r
+(EFIAPI *EFI_PEI_CPU_IO_PPI_MEM_WRITE32)(\r
   IN  EFI_PEI_SERVICES        **PeiServices,\r
   IN  EFI_PEI_CPU_IO_PPI      *This,\r
   IN  UINT64                  Address,\r
@@ -377,7 +381,7 @@ VOID
 **/\r
 typedef\r
 VOID\r
-(EFIAPI *EFI_PEI_CPU_IO_PPI_MEM_WRITE64) (\r
+(EFIAPI *EFI_PEI_CPU_IO_PPI_MEM_WRITE64)(\r
   IN  EFI_PEI_SERVICES        **PeiServices,\r
   IN  EFI_PEI_CPU_IO_PPI      *This,\r
   IN  UINT64                  Address,\r
@@ -465,6 +469,6 @@ struct _EFI_PEI_CPU_IO_PPI {
   EFI_PEI_CPU_IO_PPI_MEM_WRITE64  MemWrite64;\r
 };\r
 \r
-extern EFI_GUID gEfiPeiCpuIoPpiInServiceTableGuid;\r
+extern EFI_GUID gEfiPeiCpuIoPpiInstalledGuid;\r
 \r
 #endif\r