]> git.proxmox.com Git - mirror_edk2.git/blobdiff - IntelFrameworkPkg/Include/Framework/StatusCode.h
improve the doxgen style comments.
[mirror_edk2.git] / IntelFrameworkPkg / Include / Framework / StatusCode.h
index 5711aa43f158b75c69b0e5e50678dba0343347f8..30fde7b0bc4ae8ab75b77998fec45f6ce5ab07c3 100644 (file)
 #define _STATUS_CODE_H_\r
 \r
 #include <Protocol/DebugSupport.h>\r
-//\r
-// Section 1\r
-// Class definitions\r
-// Values of 4-127 are reserved for future use by this\r
-// specification.\r
-// Values in the range 127-255 are reserved for OEM use.\r
-//\r
+///\r
+/// Section 1\r
+/// Class definitions\r
+/// Values of 4-127 are reserved for future use by this\r
+/// specification.\r
+/// Values in the range 127-255 are reserved for OEM use.\r
+///@{\r
 #define EFI_COMPUTING_UNIT  0x00000000\r
 #define EFI_PERIPHERAL      0x01000000\r
 #define EFI_IO_BUS          0x02000000\r
 #define EFI_SOFTWARE        0x03000000\r
+///@}\r
 \r
-//\r
-// General partitioning scheme for Progress and Error Codes are\r
-// 0x0000-0x0FFF  - Shared by all sub-classes in a given class\r
-// 0x1000-0x7FFF  - Subclass Specific\r
-// 0x8000-0xFFFF  - OEM specific\r
-//\r
+///\r
+/// General partitioning scheme for Progress and Error Codes are\r
+/// 0x0000-0x0FFF  - Shared by all sub-classes in a given class\r
+/// 0x1000-0x7FFF  - Subclass Specific\r
+/// 0x8000-0xFFFF  - OEM specific\r
+///@{\r
 #define EFI_SUBCLASS_SPECIFIC 0x1000\r
 #define EFI_OEM_SPECIFIC      0x8000\r
-\r
-// \r
-// Section 2\r
-// Computing Unit Subclass definitions.\r
-// Values of 8-127 are reserved for future use by this\r
-// specification.\r
-// Values of 128-255 are reserved for OEM use.\r
-//\r
+///@}\r
+\r
+/// \r
+/// Section 2\r
+/// Computing Unit Subclass definitions.\r
+/// Values of 8-127 are reserved for future use by this\r
+/// specification.\r
+/// Values of 128-255 are reserved for OEM use.\r
+///@{\r
 #define EFI_COMPUTING_UNIT_UNSPECIFIED        (EFI_COMPUTING_UNIT | 0x00000000)\r
 #define EFI_COMPUTING_UNIT_HOST_PROCESSOR     (EFI_COMPUTING_UNIT | 0x00010000)\r
 #define EFI_COMPUTING_UNIT_FIRMWARE_PROCESSOR (EFI_COMPUTING_UNIT | 0x00020000)\r
 #define EFI_COMPUTING_UNIT_CACHE              (EFI_COMPUTING_UNIT | 0x00040000)\r
 #define EFI_COMPUTING_UNIT_MEMORY             (EFI_COMPUTING_UNIT | 0x00050000)\r
 #define EFI_COMPUTING_UNIT_CHIPSET            (EFI_COMPUTING_UNIT | 0x00060000)\r
+///@}\r
 \r
-//\r
-// Computing Unit Class Progress Code definitions.\r
-// These are shared by all subclasses.\r
-//\r
+///\r
+/// Computing Unit Class Progress Code definitions.\r
+/// These are shared by all subclasses.\r
+///@{\r
 #define EFI_CU_PC_INIT_BEGIN  0x00000000\r
 #define EFI_CU_PC_INIT_END    0x00000001\r
+///@}\r
 \r
-//\r
-// The reason that the processor was disabled.\r
-//\r
+///\r
+/// The reason that the processor was disabled.\r
+///@{\r
 #define EFI_CPU_CAUSE_NOT_DISABLED              0x0000\r
 #define EFI_CPU_CAUSE_INTERNAL_ERROR            0x0001\r
 #define EFI_CPU_CAUSE_THERMAL_ERROR             0x0002\r
 #define EFI_CPU_CAUSE_USER_SELECTION            0x0080\r
 #define EFI_CPU_CAUSE_BY_ASSOCIATION            0x0100\r
 #define EFI_CPU_CAUSE_UNSPECIFIED               0x8000\r
+///@}\r
 \r
 typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;\r
 //\r
 // Computing Unit Unspecified Subclass Progress Code definitions.\r
 //\r
-//\r
-// Computing Unit Host Processor Subclass Progress Code definitions.\r
-//\r
+///\r
+/// Computing Unit Host Processor Subclass Progress Code definitions.\r
+///@{\r
 #define EFI_CU_HP_PC_POWER_ON_INIT          (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_CU_HP_PC_CACHE_INIT             (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
 #define EFI_CU_HP_PC_RAM_INIT               (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
@@ -106,6 +111,7 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_CU_HP_PC_BSP_RESELECT           (EFI_SUBCLASS_SPECIFIC | 0x00000006)\r
 #define EFI_CU_HP_PC_AP_INIT                (EFI_SUBCLASS_SPECIFIC | 0x00000007)\r
 #define EFI_CU_HP_PC_SMM_INIT               (EFI_SUBCLASS_SPECIFIC | 0x00000008)\r
+///@}\r
 \r
 //\r
 // Computing Unit Firmware Processor Subclass Progress Code definitions.\r
@@ -113,15 +119,16 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 //\r
 // Computing Unit IO Processor Subclass Progress Code definitions.\r
 //\r
-//\r
-// Computing Unit Cache Subclass Progress Code definitions.\r
-//\r
+///\r
+/// Computing Unit Cache Subclass Progress Code definitions.\r
+///@{\r
 #define EFI_CU_CACHE_PC_PRESENCE_DETECT (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_CU_CACHE_PC_CONFIGURATION   (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
+///@}\r
 \r
-//\r
-// Computing Unit Memory Subclass Progress Code definitions.\r
-//\r
+///\r
+/// Computing Unit Memory Subclass Progress Code definitions.\r
+///@{\r
 #define EFI_CU_MEMORY_PC_SPD_READ         (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_CU_MEMORY_PC_PRESENCE_DETECT  (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
 #define EFI_CU_MEMORY_PC_TIMING           (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
@@ -129,26 +136,28 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_CU_MEMORY_PC_OPTIMIZING       (EFI_SUBCLASS_SPECIFIC | 0x00000004)\r
 #define EFI_CU_MEMORY_PC_INIT             (EFI_SUBCLASS_SPECIFIC | 0x00000005)\r
 #define EFI_CU_MEMORY_PC_TEST             (EFI_SUBCLASS_SPECIFIC | 0x00000006)\r
+///@}\r
 \r
 //\r
 // Computing Unit Chipset Subclass Progress Code definitions.\r
 //\r
-//\r
-// Computing Unit Class Error Code definitions.\r
-// These are shared by all subclasses.\r
-//\r
+///\r
+/// Computing Unit Class Error Code definitions.\r
+/// These are shared by all subclasses.\r
+///@{\r
 #define EFI_CU_EC_NON_SPECIFIC    0x00000000\r
 #define EFI_CU_EC_DISABLED        0x00000001\r
 #define EFI_CU_EC_NOT_SUPPORTED   0x00000002\r
 #define EFI_CU_EC_NOT_DETECTED    0x00000003\r
 #define EFI_CU_EC_NOT_CONFIGURED  0x00000004\r
+///@}\r
 \r
 //\r
 // Computing Unit Unspecified Subclass Error Code definitions.\r
 //\r
-//\r
-// Computing Unit Host Processor Subclass Error Code definitions.\r
-//\r
+///\r
+/// Computing Unit Host Processor Subclass Error Code definitions.\r
+///@{\r
 #define EFI_CU_HP_EC_INVALID_TYPE         (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_CU_HP_EC_INVALID_SPEED        (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
 #define EFI_CU_HP_EC_MISMATCH             (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
@@ -163,28 +172,31 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_CU_HP_EC_CORRECTABLE          (EFI_SUBCLASS_SPECIFIC | 0x0000000B)\r
 #define EFI_CU_HP_EC_UNCORRECTABLE        (EFI_SUBCLASS_SPECIFIC | 0x0000000C)\r
 #define EFI_CU_HP_EC_NO_MICROCODE_UPDATE  (EFI_SUBCLASS_SPECIFIC | 0x0000000D)\r
+///@}\r
 \r
-//\r
-// Computing Unit Firmware Processor Subclass Error Code definitions.\r
-//\r
+///\r
+/// Computing Unit Firmware Processor Subclass Error Code definitions.\r
+///@{\r
 #define EFI_CU_FP_EC_HARD_FAIL  (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_CU_FP_EC_SOFT_FAIL  (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
 #define EFI_CU_FP_EC_COMM_ERROR (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
+///@}\r
 \r
 //\r
 // Computing Unit IO Processor Subclass Error Code definitions.\r
 //\r
-//\r
-// Computing Unit Cache Subclass Error Code definitions.\r
-//\r
+///\r
+/// Computing Unit Cache Subclass Error Code definitions.\r
+///@{\r
 #define EFI_CU_CACHE_EC_INVALID_TYPE  (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_CU_CACHE_EC_INVALID_SPEED (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
 #define EFI_CU_CACHE_EC_INVALID_SIZE  (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
 #define EFI_CU_CACHE_EC_MISMATCH      (EFI_SUBCLASS_SPECIFIC | 0x00000003)\r
+///@}\r
 \r
-//\r
-// Computing Unit Memory Subclass Error Code definitions.\r
-//\r
+///\r
+/// Computing Unit Memory Subclass Error Code definitions.\r
+///@{\r
 #define EFI_CU_MEMORY_EC_INVALID_TYPE   (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_CU_MEMORY_EC_INVALID_SPEED  (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
 #define EFI_CU_MEMORY_EC_CORRECTABLE    (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
@@ -196,18 +208,19 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_CU_MEMORY_EC_UPDATE_FAIL    (EFI_SUBCLASS_SPECIFIC | 0x00000008)\r
 #define EFI_CU_MEMORY_EC_NONE_DETECTED  (EFI_SUBCLASS_SPECIFIC | 0x00000009)\r
 #define EFI_CU_MEMORY_EC_NONE_USEFUL    (EFI_SUBCLASS_SPECIFIC | 0x0000000A)\r
+///@}\r
 \r
 //\r
 // Computing Unit Chipset Subclass Error Code definitions.\r
 //\r
 \r
-//\r
-// Section 3\r
-// Peripheral Subclass definitions.\r
-// Values of 12-127 are reserved for future use by this\r
-// specification.\r
-// Values of 128-255 are reserved for OEM use.\r
-//\r
+///\r
+/// Section 3\r
+/// Peripheral Subclass definitions.\r
+/// Values of 12-127 are reserved for future use by this\r
+/// specification.\r
+/// Values of 128-255 are reserved for OEM use.\r
+///@{\r
 #define EFI_PERIPHERAL_UNSPECIFIED      (EFI_PERIPHERAL | 0x00000000)\r
 #define EFI_PERIPHERAL_KEYBOARD         (EFI_PERIPHERAL | 0x00010000)\r
 #define EFI_PERIPHERAL_MOUSE            (EFI_PERIPHERAL | 0x00020000)\r
@@ -221,11 +234,12 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_PERIPHERAL_AUDIO_OUTPUT     (EFI_PERIPHERAL | 0x000A0000)\r
 #define EFI_PERIPHERAL_LCD_DEVICE       (EFI_PERIPHERAL | 0x000B0000)\r
 #define EFI_PERIPHERAL_NETWORK          (EFI_PERIPHERAL | 0x000C0000)\r
+///@}\r
 \r
-//\r
-// Peripheral Class Progress Code definitions.\r
-// These are shared by all subclasses.\r
-//\r
+///\r
+/// Peripheral Class Progress Code definitions.\r
+/// These are shared by all subclasses.\r
+///@{\r
 #define EFI_P_PC_INIT             0x00000000\r
 #define EFI_P_PC_RESET            0x00000001\r
 #define EFI_P_PC_DISABLE          0x00000002\r
@@ -233,15 +247,17 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_P_PC_ENABLE           0x00000004\r
 #define EFI_P_PC_RECONFIG         0x00000005\r
 #define EFI_P_PC_DETECTED         0x00000006\r
+///@}\r
 \r
 //\r
 // Peripheral Class Unspecified Subclass Progress Code definitions.\r
 //\r
-//\r
-// Peripheral Class Keyboard Subclass Progress Code definitions.\r
-//\r
+///\r
+/// Peripheral Class Keyboard Subclass Progress Code definitions.\r
+///@{\r
 #define EFI_P_KEYBOARD_PC_CLEAR_BUFFER  (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_P_KEYBOARD_PC_SELF_TEST     (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
+///@}\r
 \r
 //\r
 // Peripheral Class Mouse Subclass Progress Code definitions.\r
@@ -280,10 +296,10 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 //\r
 // Peripheral Class Network Subclass Progress Code definitions.\r
 //\r
-//\r
-// Peripheral Class Error Code definitions.\r
-// These are shared by all subclasses.\r
-//\r
+///\r
+/// Peripheral Class Error Code definitions.\r
+/// These are shared by all subclasses.\r
+///@{\r
 #define EFI_P_EC_NON_SPECIFIC       0x00000000\r
 #define EFI_P_EC_DISABLED           0x00000001\r
 #define EFI_P_EC_NOT_SUPPORTED      0x00000002\r
@@ -294,15 +310,17 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_P_EC_INPUT_ERROR        0x00000007\r
 #define EFI_P_EC_OUTPUT_ERROR       0x00000008\r
 #define EFI_P_EC_RESOURCE_CONFLICT  0x00000009\r
+///@}\r
 \r
 //\r
 // Peripheral Class Unspecified Subclass Error Code definitions.\r
 //\r
-//\r
-// Peripheral Class Keyboard Subclass Error Code definitions.\r
-//\r
+///\r
+/// Peripheral Class Keyboard Subclass Error Code definitions.\r
+///@{\r
 #define EFI_P_KEYBOARD_EC_LOCKED    (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_P_KEYBOARD_EC_STUCK_KEY (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
+///@}\r
 \r
 //\r
 // Peripheral Class Mouse Subclass Error Code definitions.\r
@@ -340,13 +358,13 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 // Peripheral Class Network Subclass Error Code definitions.\r
 //\r
 \r
-//\r
-// Section 4\r
-// IO Bus Subclass definitions.\r
-// Values of 14-127 are reserved for future use by this\r
-// specification.\r
-// Values of 128-255 are reserved for OEM use.\r
-//\r
+///\r
+/// Section 4\r
+/// IO Bus Subclass definitions.\r
+/// Values of 14-127 are reserved for future use by this\r
+/// specification.\r
+/// Values of 128-255 are reserved for OEM use.\r
+///@{\r
 #define EFI_IO_BUS_UNSPECIFIED  (EFI_IO_BUS | 0x00000000)\r
 #define EFI_IO_BUS_PCI          (EFI_IO_BUS | 0x00010000)\r
 #define EFI_IO_BUS_USB          (EFI_IO_BUS | 0x00020000)\r
@@ -360,11 +378,12 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_IO_BUS_IP_NETWORK   (EFI_IO_BUS | 0x000A0000)\r
 #define EFI_IO_BUS_SMBUS        (EFI_IO_BUS | 0x000B0000)\r
 #define EFI_IO_BUS_I2C          (EFI_IO_BUS | 0x000C0000)\r
+///@}\r
 \r
-//\r
-// IO Bus Class Progress Code definitions.\r
-// These are shared by all subclasses.\r
-//\r
+///\r
+/// IO Bus Class Progress Code definitions.\r
+/// These are shared by all subclasses.\r
+///@{\r
 #define EFI_IOB_PC_INIT     0x00000000\r
 #define EFI_IOB_PC_RESET    0x00000001\r
 #define EFI_IOB_PC_DISABLE  0x00000002\r
@@ -372,16 +391,18 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_IOB_PC_ENABLE   0x00000004\r
 #define EFI_IOB_PC_RECONFIG 0x00000005\r
 #define EFI_IOB_PC_HOTPLUG  0x00000006\r
+///@}\r
 \r
 //\r
 // IO Bus Class Unspecified Subclass Progress Code definitions.\r
 //\r
-//\r
-// IO Bus Class PCI Subclass Progress Code definitions.\r
-//\r
+///\r
+/// IO Bus Class PCI Subclass Progress Code definitions.\r
+///@{\r
 #define EFI_IOB_PCI_PC_BUS_ENUM   (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_IOB_PCI_PC_RES_ALLOC  (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
 #define EFI_IOB_PCI_PC_HPC_INIT   (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
+///@}\r
 \r
 //\r
 // IO Bus Class USB Subclass Progress Code definitions.\r
@@ -404,6 +425,17 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 //\r
 // IO Bus Class ATA/ATAPI Subclass Progress Code definitions.\r
 //\r
+///\r
+/// Inconsistent with specification here: \r
+/// The Framework Spec, StatusCodes0.92, does not define the macro. And the definition\r
+/// is expected to be adopt by PI Spec.\r
+///@{\r
+#define EFI_IOB_ATA_BUS_SMART_ENABLE          (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
+#define EFI_IOB_ATA_BUS_SMART_DISABLE         (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
+#define EFI_IOB_ATA_BUS_SMART_OVERTHRESHOLD   (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
+#define EFI_IOB_ATA_BUS_SMART_UNDERTHRESHOLD  (EFI_SUBCLASS_SPECIFIC | 0x00000003)\r
+///@}\r
+\r
 //\r
 // IO Bus Class FC Subclass Progress Code definitions.\r
 //\r
@@ -416,10 +448,10 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 //\r
 // IO Bus Class I2C Subclass Progress Code definitions.\r
 //\r
-//\r
-// IO Bus Class Error Code definitions.\r
-// These are shared by all subclasses.\r
-//\r
+///\r
+/// IO Bus Class Error Code definitions.\r
+/// These are shared by all subclasses.\r
+///@{\r
 #define EFI_IOB_EC_NON_SPECIFIC       0x00000000\r
 #define EFI_IOB_EC_DISABLED           0x00000001\r
 #define EFI_IOB_EC_NOT_SUPPORTED      0x00000002\r
@@ -430,15 +462,17 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_IOB_EC_READ_ERROR         0x00000007\r
 #define EFI_IOB_EC_WRITE_ERROR        0x00000008\r
 #define EFI_IOB_EC_RESOURCE_CONFLICT  0x00000009\r
+///@}\r
 \r
 //\r
 // IO Bus Class Unspecified Subclass Error Code definitions.\r
 //\r
-//\r
-// IO Bus Class PCI Subclass Error Code definitions.\r
-//\r
+///\r
+/// IO Bus Class PCI Subclass Error Code definitions.\r
+///@{\r
 #define EFI_IOB_PCI_EC_PERR (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_IOB_PCI_EC_SERR (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
+///@}\r
 \r
 //\r
 // IO Bus Class USB Subclass Error Code definitions.\r
@@ -461,8 +495,14 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 //\r
 // IO Bus Class ATA/ATAPI Subclass Error Code definitions.\r
 //\r
+///\r
+/// Inconsistent with specification here: \r
+/// The Framework Spec, StatusCodes0.92, does not define the macro. And the definition\r
+/// is expected to be adopt by PI Spec.\r
+///@{\r
 #define EFI_IOB_ATA_BUS_SMART_NOTSUPPORTED  (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_IOB_ATA_BUS_SMART_DISABLED      (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
+///@}\r
 \r
 //\r
 // IO Bus Class FC Subclass Error Code definitions.\r
@@ -477,13 +517,13 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 // IO Bus Class I2C Subclass Error Code definitions.\r
 //\r
 \r
-//\r
-// Section 5\r
-// Software Subclass definitions.\r
-// Values of 14-127 are reserved for future use by this\r
-// specification.\r
-// Values of 128-255 are reserved for OEM use.\r
-//\r
+///\r
+/// Section 5\r
+/// Software Subclass definitions.\r
+/// Values of 14-127 are reserved for future use by this\r
+/// specification.\r
+/// Values of 128-255 are reserved for OEM use.\r
+///@{\r
 #define EFI_SOFTWARE_UNSPECIFIED          (EFI_SOFTWARE | 0x00000000)\r
 #define EFI_SOFTWARE_SEC                  (EFI_SOFTWARE | 0x00010000)\r
 #define EFI_SOFTWARE_PEI_CORE             (EFI_SOFTWARE | 0x00020000)\r
@@ -503,12 +543,18 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_SOFTWARE_EFI_BOOT_SERVICE     (EFI_SOFTWARE | 0x00100000)\r
 #define EFI_SOFTWARE_EFI_RUNTIME_SERVICE  (EFI_SOFTWARE | 0x00110000)\r
 #define EFI_SOFTWARE_EFI_DXE_SERVICE      (EFI_SOFTWARE | 0x00120000)\r
+///\r
+/// Inconsistent with specification here: \r
+/// The Framework Spec, StatusCodes0.92, does not define the macro. And the definition\r
+/// is expected to be adopt by PI Spec.\r
+///\r
 #define EFI_SOFTWARE_X64_EXCEPTION        (EFI_SOFTWARE | 0x00130000)\r
+///@}\r
 \r
-//\r
-// Software Class Progress Code definitions.\r
-// These are shared by all subclasses.\r
-//\r
+///\r
+/// Software Class Progress Code definitions.\r
+/// These are shared by all subclasses.\r
+///@{\r
 #define EFI_SW_PC_INIT                0x00000000\r
 #define EFI_SW_PC_LOAD                0x00000001\r
 #define EFI_SW_PC_INIT_BEGIN          0x00000002\r
@@ -517,71 +563,78 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_SW_PC_AUTHENTICATE_END    0x00000005\r
 #define EFI_SW_PC_INPUT_WAIT          0x00000006\r
 #define EFI_SW_PC_USER_SETUP          0x00000007\r
+///@}\r
 \r
 //\r
 // Software Class Unspecified Subclass Progress Code definitions.\r
 //\r
-//\r
-// Software Class SEC Subclass Progress Code definitions.\r
-//\r
+///\r
+/// Software Class SEC Subclass Progress Code definitions.\r
+///@{\r
 #define EFI_SW_SEC_PC_ENTRY_POINT     (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_SW_SEC_PC_HANDOFF_TO_NEXT (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
+///@}\r
 \r
-//\r
-// Software Class PEI Core Subclass Progress Code definitions.\r
-//\r
+///\r
+/// Software Class PEI Core Subclass Progress Code definitions.\r
+///@{\r
 #define EFI_SW_PEI_CORE_PC_ENTRY_POINT      (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_SW_PEI_CORE_PC_HANDOFF_TO_NEXT  (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
 #define EFI_SW_PEI_CORE_PC_RETURN_TO_LAST   (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
+///@}\r
 \r
-//\r
-// Software Class PEI Module Subclass Progress Code definitions.\r
-//\r
+///\r
+/// Software Class PEI Module Subclass Progress Code definitions.\r
+///@{\r
 #define EFI_SW_PEIM_PC_RECOVERY_BEGIN (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_SW_PEIM_PC_CAPSULE_LOAD   (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
 #define EFI_SW_PEIM_PC_CAPSULE_START  (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
 #define EFI_SW_PEIM_PC_RECOVERY_USER  (EFI_SUBCLASS_SPECIFIC | 0x00000003)\r
 #define EFI_SW_PEIM_PC_RECOVERY_AUTO  (EFI_SUBCLASS_SPECIFIC | 0x00000004)\r
+///@}\r
 \r
-//\r
-// Software Class DXE Core Subclass Progress Code definitions.\r
-//\r
+///\r
+/// Software Class DXE Core Subclass Progress Code definitions.\r
+///@{\r
 #define EFI_SW_DXE_CORE_PC_ENTRY_POINT      (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_SW_DXE_CORE_PC_HANDOFF_TO_NEXT  (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
 #define EFI_SW_DXE_CORE_PC_RETURN_TO_LAST   (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
 #define EFI_SW_DXE_CORE_PC_START_DRIVER     (EFI_SUBCLASS_SPECIFIC | 0x00000003)\r
+///@}\r
 \r
-//\r
-// Software Class DXE BS Driver Subclass Progress Code definitions.\r
-//\r
+///\r
+/// Software Class DXE BS Driver Subclass Progress Code definitions.\r
+///@{\r
 #define EFI_SW_DXE_BS_PC_LEGACY_OPROM_INIT            (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_SW_DXE_BS_PC_READY_TO_BOOT_EVENT          (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
 #define EFI_SW_DXE_BS_PC_LEGACY_BOOT_EVENT            (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
 #define EFI_SW_DXE_BS_PC_EXIT_BOOT_SERVICES_EVENT     (EFI_SUBCLASS_SPECIFIC | 0x00000003)\r
 #define EFI_SW_DXE_BS_PC_VIRTUAL_ADDRESS_CHANGE_EVENT (EFI_SUBCLASS_SPECIFIC | 0x00000004)\r
+///@}\r
+\r
 ///\r
 /// Inconsistent with specification here: \r
-/// In Framework Spec, Status0.92, no following two macro. And it is expectable that\r
-/// to add the definitions to Framework Spec.\r
-///\r
+/// The Framework Spec, StatusCodes0.92, does not define the macro. And the definition\r
+/// is expected to be adopt by PI Spec.\r
+///@{\r
 #define EFI_SW_DXE_BS_PC_BEGIN_CONNECTING_DRIVERS     (EFI_SUBCLASS_SPECIFIC | 0x00000005)\r
 #define EFI_SW_DXE_BS_PC_VERIFYING_PASSWORD           (EFI_SUBCLASS_SPECIFIC | 0x00000006)\r
+///@}\r
 \r
 ///\r
-/// Inconsistent with specification here: \r
-/// In Framework Spec, Status0.92, no following two macro. And it is expectable that\r
-/// to add the definitions to Framework Spec.\r
+/// Software Class DXE RT Driver Subclass Progress Code definitions.\r
 ///\r
-\r
-//\r
-// Software Class DXE RT Driver Subclass Progress Code definitions.\r
-//\r
+/// Inconsistent with specification here: \r
+/// The Framework Spec, StatusCodes0.92, does not define the macro. And the definition\r
+/// is expected to be adopt by PI Spec.\r
+///@{\r
 #define EFI_SW_DXE_RT_PC_S0 (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_SW_DXE_RT_PC_S1 (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
 #define EFI_SW_DXE_RT_PC_S2 (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
 #define EFI_SW_DXE_RT_PC_S3 (EFI_SUBCLASS_SPECIFIC | 0x00000003)\r
 #define EFI_SW_DXE_RT_PC_S4 (EFI_SUBCLASS_SPECIFIC | 0x00000004)\r
 #define EFI_SW_DXE_RT_PC_S5 (EFI_SUBCLASS_SPECIFIC | 0x00000005)\r
+///@}\r
 \r
 //\r
 // Software Class SMM Driver Subclass Progress Code definitions.\r
@@ -592,18 +645,20 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 //\r
 // Software Class EFI OS Loader Subclass Progress Code definitions.\r
 //\r
-//\r
-// Software Class EFI RT Subclass Progress Code definitions.\r
-//\r
+///\r
+/// Software Class EFI RT Subclass Progress Code definitions.\r
+///@{\r
 #define EFI_SW_RT_PC_ENTRY_POINT      (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_SW_RT_PC_HANDOFF_TO_NEXT  (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
 #define EFI_SW_RT_PC_RETURN_TO_LAST   (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
+///@}\r
 \r
-//\r
-// Software Class EFI AL Subclass Progress Code definitions.\r
-//\r
+///\r
+/// Software Class EFI AL Subclass Progress Code definitions.\r
+///@{\r
 #define EFI_SW_AL_PC_ENTRY_POINT    (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_SW_AL_PC_RETURN_TO_LAST (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
+///@}\r
 \r
 //\r
 // Software Class EBC Exception Subclass Progress Code definitions.\r
@@ -617,9 +672,9 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 //\r
 // Software Class IPF Exception Subclass Progress Code definitions.\r
 //\r
-//\r
-// Software Class PEI Services Subclass Progress Code definitions.\r
-//\r
+///\r
+/// Software Class PEI Services Subclass Progress Code definitions.\r
+///@{\r
 #define EFI_SW_PS_PC_INSTALL_PPI            (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_SW_PS_PC_REINSTALL_PPI          (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
 #define EFI_SW_PS_PC_LOCATE_PPI             (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
@@ -636,10 +691,11 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_SW_PS_PC_ALLOCATE_POOL          (EFI_SUBCLASS_SPECIFIC | 0x0000000D)\r
 #define EFI_SW_PS_PC_COPY_MEM               (EFI_SUBCLASS_SPECIFIC | 0x0000000E)\r
 #define EFI_SW_PS_PC_SET_MEM                (EFI_SUBCLASS_SPECIFIC | 0x0000000F)\r
+///@}\r
 \r
-//\r
-// Software Class EFI Boot Services Subclass Progress Code definitions.\r
-//\r
+///\r
+/// Software Class EFI Boot Services Subclass Progress Code definitions.\r
+///@{\r
 #define EFI_SW_BS_PC_RAISE_TPL                      (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_SW_BS_PC_RESTORE_TPL                    (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
 #define EFI_SW_BS_PC_ALLOCATE_PAGES                 (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
@@ -682,10 +738,11 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_SW_BS_PC_CALCULATE_CRC_32               (EFI_SUBCLASS_SPECIFIC | 0x00000027)\r
 #define EFI_SW_BS_PC_COPY_MEM                       (EFI_SUBCLASS_SPECIFIC | 0x00000028)\r
 #define EFI_SW_BS_PC_SET_MEM                        (EFI_SUBCLASS_SPECIFIC | 0x00000029)\r
+///@}\r
 \r
-//\r
-// Software Class EFI Runtime Services Subclass Progress Code definitions.\r
-//\r
+///\r
+/// Software Class EFI Runtime Services Subclass Progress Code definitions.\r
+///@{\r
 #define EFI_SW_RS_PC_GET_TIME                       (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_SW_RS_PC_SET_TIME                       (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
 #define EFI_SW_RS_PC_GET_WAKEUP_TIME                (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
@@ -697,10 +754,11 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_SW_RS_PC_SET_VARIABLE                   (EFI_SUBCLASS_SPECIFIC | 0x00000008)\r
 #define EFI_SW_RS_PC_GET_NEXT_HIGH_MONOTONIC_COUNT  (EFI_SUBCLASS_SPECIFIC | 0x00000009)\r
 #define EFI_SW_RS_PC_RESET_SYSTEM                   (EFI_SUBCLASS_SPECIFIC | 0x0000000A)\r
+///@{\r
 \r
-//\r
-// Software Class EFI DXE Services Subclass Progress Code definitions\r
-//\r
+///\r
+/// Software Class EFI DXE Services Subclass Progress Code definitions\r
+///@{\r
 #define EFI_SW_DS_PC_ADD_MEMORY_SPACE             (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_SW_DS_PC_ALLOCATE_MEMORY_SPACE        (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
 #define EFI_SW_DS_PC_FREE_MEMORY_SPACE            (EFI_SUBCLASS_SPECIFIC | 0x00000002)\r
@@ -718,11 +776,12 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_SW_DS_PC_SCHEDULE                     (EFI_SUBCLASS_SPECIFIC | 0x0000000E)\r
 #define EFI_SW_DS_PC_TRUST                        (EFI_SUBCLASS_SPECIFIC | 0x0000000F)\r
 #define EFI_SW_DS_PC_PROCESS_FIRMWARE_VOLUME      (EFI_SUBCLASS_SPECIFIC | 0x00000010)\r
+///@}\r
 \r
-//\r
-// Software Class Error Code definitions.\r
-// These are shared by all subclasses.\r
-//\r
+///\r
+/// Software Class Error Code definitions.\r
+/// These are shared by all subclasses.\r
+///@{\r
 #define EFI_SW_EC_NON_SPECIFIC            0x00000000\r
 #define EFI_SW_EC_LOAD_ERROR              0x00000001\r
 #define EFI_SW_EC_INVALID_PARAMETER       0x00000002\r
@@ -741,6 +800,7 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_SW_EC_PWD_CLR_REQUEST         0x0000000F\r
 #define EFI_SW_EC_PWD_CLEARED             0x00000010\r
 #define EFI_SW_EC_EVENT_LOG_FULL          0x00000011\r
+///@}\r
 \r
 //\r
 // Software Class Unspecified Subclass Error Code definitions.\r
@@ -748,24 +808,29 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 //\r
 // Software Class SEC Subclass Error Code definitions.\r
 //\r
-//\r
-// Software Class PEI Core Subclass Error Code definitions.\r
-//\r
+///\r
+/// Software Class PEI Core Subclass Error Code definitions.\r
+///\r
 #define EFI_SW_PEI_CORE_EC_DXE_CORRUPT  (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 \r
-//\r
-// Software Class PEI Module Subclass Error Code definitions.\r
-//\r
+///\r
+/// Software Class PEI Module Subclass Error Code definitions.\r
+///@{\r
 #define EFI_SW_PEIM_EC_NO_RECOVERY_CAPSULE        (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 #define EFI_SW_PEIM_EC_INVALID_CAPSULE_DESCRIPTOR (EFI_SUBCLASS_SPECIFIC | 0x00000001)\r
+///@}\r
 \r
-//\r
-// Software Class DXE Core Subclass Error Code definitions.\r
-//\r
+///\r
+/// Software Class DXE Core Subclass Error Code definitions.\r
+///\r
+/// Inconsistent with specification here: \r
+/// The Framework Spec, StatusCodes0.92, does not define the macro. And the definition\r
+/// is expected to be adopt by PI Spec.\r
+///\r
 #define EFI_SW_CSM_LEGACY_ROM_INIT  (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
-//\r
-// Software Class DXE Boot Service Driver Subclass Error Code definitions.\r
-//\r
+///\r
+/// Software Class DXE Boot Service Driver Subclass Error Code definitions.\r
+///\r
 #define EFI_SW_DXE_BS_EC_LEGACY_OPROM_NO_SPACE  (EFI_SUBCLASS_SPECIFIC | 0x00000000)\r
 \r
 //\r
@@ -786,11 +851,11 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 //\r
 // Software Class EFI AL Subclass Error Code definitions.\r
 //\r
-//\r
-// Software Class EBC Exception Subclass Error Code definitions.\r
-// These exceptions are derived from the debug protocol definitions in the EFI\r
-// specification.\r
-//\r
+///\r
+/// Software Class EBC Exception Subclass Error Code definitions.\r
+/// These exceptions are derived from the debug protocol definitions in the EFI\r
+/// specification.\r
+///@{\r
 #define EFI_SW_EC_EBC_UNDEFINED             0x00000000\r
 #define EFI_SW_EC_EBC_DIVIDE_ERROR          EXCEPT_EBC_DIVIDE_ERROR\r
 #define EFI_SW_EC_EBC_DEBUG                 EXCEPT_EBC_DEBUG\r
@@ -802,12 +867,13 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_SW_EC_EBC_INSTRUCTION_ENCODING  EXCEPT_EBC_INSTRUCTION_ENCODING\r
 #define EFI_SW_EC_EBC_BAD_BREAK             EXCEPT_EBC_BAD_BREAK\r
 #define EFI_SW_EC_EBC_STEP                  EXCEPT_EBC_STEP\r
+///@}\r
 \r
-//\r
-// Software Class IA32 Exception Subclass Error Code definitions.\r
-// These exceptions are derived from the debug protocol definitions in the EFI\r
-// specification.\r
-//\r
+///\r
+/// Software Class IA32 Exception Subclass Error Code definitions.\r
+/// These exceptions are derived from the debug protocol definitions in the EFI\r
+/// specification.\r
+///@{\r
 #define EFI_SW_EC_IA32_DIVIDE_ERROR     EXCEPT_IA32_DIVIDE_ERROR\r
 #define EFI_SW_EC_IA32_DEBUG            EXCEPT_IA32_DEBUG\r
 #define EFI_SW_EC_IA32_NMI              EXCEPT_IA32_NMI\r
@@ -825,18 +891,17 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_SW_EC_IA32_ALIGNMENT_CHECK  EXCEPT_IA32_ALIGNMENT_CHECK\r
 #define EFI_SW_EC_IA32_MACHINE_CHECK    EXCEPT_IA32_MACHINE_CHECK\r
 #define EFI_SW_EC_IA32_SIMD             EXCEPT_IA32_SIMD\r
+///@}\r
 \r
 ///\r
-/// Inconsistent with specification here: \r
-/// In Framework Spec, Status0.92, no following two macro. And it is expectable that\r
-/// to add the definitions to Framework Spec.\r
+/// Software Class X64 Exception Subclass Error Code definitions.\r
+/// These exceptions are derived from the debug protocol definitions in the EFI\r
+/// specification.\r
 ///\r
-\r
-//\r
-// Software Class X64 Exception Subclass Error Code definitions.\r
-// These exceptions are derived from the debug protocol definitions in the EFI\r
-// specification.\r
-//\r
+/// Inconsistent with specification here: \r
+/// The Framework Spec, StatusCodes0.92, does not define the macro. And the definition\r
+/// is expected to be adopt by PI Spec.\r
+///@{\r
 #define EFI_SW_EC_X64_DIVIDE_ERROR      EXCEPT_X64_DIVIDE_ERROR\r
 #define EFI_SW_EC_X64_DEBUG             EXCEPT_X64_DEBUG\r
 #define EFI_SW_EC_X64_NMI               EXCEPT_X64_NMI\r
@@ -854,12 +919,13 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_SW_EC_X64_ALIGNMENT_CHECK   EXCEPT_X64_ALIGNMENT_CHECK\r
 #define EFI_SW_EC_X64_MACHINE_CHECK     EXCEPT_X64_MACHINE_CHECK\r
 #define EFI_SW_EC_X64_SIMD              EXCEPT_X64_SIMD\r
+///@}\r
 \r
-//\r
-// Software Class IPF Exception Subclass Error Code definitions.\r
-// These exceptions are derived from the debug protocol definitions in the EFI\r
-// specification.\r
-//\r
+///\r
+/// Software Class IPF Exception Subclass Error Code definitions.\r
+/// These exceptions are derived from the debug protocol definitions in the EFI\r
+/// specification.\r
+///@{\r
 #define EFI_SW_EC_IPF_ALT_DTLB            EXCEPT_IPF_ALT_DTLB\r
 #define EFI_SW_EC_IPF_DNESTED_TLB         EXCEPT_IPF_DNESTED_TLB\r
 #define EFI_SW_EC_IPF_BREAKPOINT          EXCEPT_IPF_BREAKPOINT\r
@@ -872,7 +938,7 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 #define EFI_SW_EC_IPF_FP_TRAP             EXCEPT_IPF_FP_TRAP\r
 #define EFI_SW_EC_IPF_TAKEN_BRANCH        EXCEPT_IPF_TAKEN_BRANCH\r
 #define EFI_SW_EC_IPF_SINGLE_STEP         EXCEPT_IPF_SINGLE_STEP\r
-\r
+///@}\r
 \r
 //\r
 // Software Class PEI Service Subclass Error Code definitions.\r
@@ -887,12 +953,12 @@ typedef UINT32                                  EFI_CPU_STATE_CHANGE_CAUSE;
 // Software Class EFI DXE Service Subclass Error Code definitions.\r
 //\r
 \r
-//\r
-// Section 6\r
-// Debug Code definitions for all classes and subclass\r
-// Only one debug code is defined at this point and should\r
-// be used for anything that gets sent to debug stream.\r
-//\r
+///\r
+/// Section 6\r
+/// Debug Code definitions for all classes and subclass\r
+/// Only one debug code is defined at this point and should\r
+/// be used for anything that gets sent to debug stream.\r
+///\r
 #define EFI_DC_UNSPECIFIED  0x0\r
 \r
 #endif\r