]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Include/Protocol/DevicePath.h
MdePkg: Apply uncrustify changes
[mirror_edk2.git] / MdePkg / Include / Protocol / DevicePath.h
index cabad21436f0dc3cf286a59abdb128b8fcffc795..9060dd782e3f675bab9e7807ce1e4c8ae95cb8a8 100644 (file)
@@ -1,18 +1,12 @@
 /** @file\r
   The device path protocol as defined in UEFI 2.0.\r
 \r
-  The device path represents a programatic path to a device. It's the view\r
-  from a software point of view. It also must persist from boot to boot, so \r
+  The device path represents a programmatic path to a device,\r
+  from a software point of view. The path must persist from boot to boot, so\r
   it can not contain things like PCI bus numbers that change from boot to boot.\r
 \r
-  Copyright (c) 2006, 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
-  http://opensource.org/licenses/bsd-license.php                                            \r
-\r
-  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
+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
+SPDX-License-Identifier: BSD-2-Clause-Patent\r
 \r
 **/\r
 \r
 #define __EFI_DEVICE_PATH_PROTOCOL_H__\r
 \r
 #include <Guid/PcAnsi.h>\r
+#include <IndustryStandard/Bluetooth.h>\r
+#include <IndustryStandard/Acpi60.h>\r
 \r
-//\r
-// Device Path protocol\r
-//\r
+///\r
+/// Device Path protocol.\r
+///\r
 #define EFI_DEVICE_PATH_PROTOCOL_GUID \\r
   { \\r
     0x9576e91, 0x6d3f, 0x11d2, {0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b } \\r
   }\r
 \r
-//\r
-// Protocol GUID defined in EFI1.1.\r
-// \r
-\r
-//\r
-// Device Path information\r
-//\r
+///\r
+/// Device Path guid definition for backward-compatible with EFI1.1.\r
+///\r
 #define DEVICE_PATH_PROTOCOL  EFI_DEVICE_PATH_PROTOCOL_GUID\r
 \r
 #pragma pack(1)\r
 \r
+/**\r
+  This protocol can be used on any device handle to obtain generic path/location\r
+  information concerning the physical device or logical device. If the handle does\r
+  not logically map to a physical device, the handle may not necessarily support\r
+  the device path protocol. The device path describes the location of the device\r
+  the handle is for. The size of the Device Path can be determined from the structures\r
+  that make up the Device Path.\r
+**/\r
 typedef struct {\r
-  UINT8 Type;\r
-  UINT8 SubType;\r
-  UINT8 Length[2];\r
+  UINT8    Type;    ///< 0x01 Hardware Device Path.\r
+                    ///< 0x02 ACPI Device Path.\r
+                    ///< 0x03 Messaging Device Path.\r
+                    ///< 0x04 Media Device Path.\r
+                    ///< 0x05 BIOS Boot Specification Device Path.\r
+                    ///< 0x7F End of Hardware Device Path.\r
+\r
+  UINT8    SubType; ///< Varies by Type\r
+                    ///< 0xFF End Entire Device Path, or\r
+                    ///< 0x01 End This Instance of a Device Path and start a new\r
+                    ///< Device Path.\r
+\r
+  UINT8    Length[2]; ///< Specific Device Path data. Type and Sub-Type define\r
+                      ///< type of data. Size of data is included in Length.\r
 } EFI_DEVICE_PATH_PROTOCOL;\r
 \r
-//\r
-// For backward-compatible with EFI1.1.\r
-// \r
-typedef EFI_DEVICE_PATH_PROTOCOL  EFI_DEVICE_PATH;\r
+///\r
+/// Device Path protocol definition for backward-compatible with EFI1.1.\r
+///\r
+typedef EFI_DEVICE_PATH_PROTOCOL EFI_DEVICE_PATH;\r
 \r
-//\r
-// Hardware Device Paths\r
-//\r
-#define HARDWARE_DEVICE_PATH      0x01\r
+///\r
+/// Hardware Device Paths.\r
+///\r
+#define HARDWARE_DEVICE_PATH  0x01\r
+\r
+///\r
+/// PCI Device Path SubType.\r
+///\r
+#define HW_PCI_DP  0x01\r
 \r
-#define HW_PCI_DP                 0x01\r
+///\r
+/// PCI Device Path.\r
+///\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT8                           Function;\r
-  UINT8                           Device;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// PCI Function Number.\r
+  ///\r
+  UINT8                       Function;\r
+  ///\r
+  /// PCI Device Number.\r
+  ///\r
+  UINT8                       Device;\r
 } PCI_DEVICE_PATH;\r
 \r
-#define HW_PCCARD_DP              0x02\r
+///\r
+/// PCCARD Device Path SubType.\r
+///\r
+#define HW_PCCARD_DP  0x02\r
+\r
+///\r
+/// PCCARD Device Path.\r
+///\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT8                           FunctionNumber;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Function Number (0 = First Function).\r
+  ///\r
+  UINT8                       FunctionNumber;\r
 } PCCARD_DEVICE_PATH;\r
 \r
-#define HW_MEMMAP_DP              0x03\r
+///\r
+/// Memory Mapped Device Path SubType.\r
+///\r
+#define HW_MEMMAP_DP  0x03\r
+\r
+///\r
+/// Memory Mapped Device Path.\r
+///\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT32                          MemoryType;\r
-  EFI_PHYSICAL_ADDRESS            StartingAddress;\r
-  EFI_PHYSICAL_ADDRESS            EndingAddress;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// EFI_MEMORY_TYPE\r
+  ///\r
+  UINT32                      MemoryType;\r
+  ///\r
+  /// Starting Memory Address.\r
+  ///\r
+  EFI_PHYSICAL_ADDRESS        StartingAddress;\r
+  ///\r
+  /// Ending Memory Address.\r
+  ///\r
+  EFI_PHYSICAL_ADDRESS        EndingAddress;\r
 } MEMMAP_DEVICE_PATH;\r
 \r
-#define HW_VENDOR_DP              0x04\r
+///\r
+/// Hardware Vendor Device Path SubType.\r
+///\r
+#define HW_VENDOR_DP  0x04\r
+\r
+///\r
+/// The Vendor Device Path allows the creation of vendor-defined Device Paths. A vendor must\r
+/// allocate a Vendor GUID for a Device Path. The Vendor GUID can then be used to define the\r
+/// contents on the n bytes that follow in the Vendor Device Path node.\r
+///\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  EFI_GUID                        Guid;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Vendor-assigned GUID that defines the data that follows.\r
+  ///\r
+  EFI_GUID                    Guid;\r
+  ///\r
+  /// Vendor-defined variable size data.\r
+  ///\r
 } VENDOR_DEVICE_PATH;\r
 \r
-#define HW_CONTROLLER_DP          0x05\r
+///\r
+/// Controller Device Path SubType.\r
+///\r
+#define HW_CONTROLLER_DP  0x05\r
+\r
+///\r
+/// Controller Device Path.\r
+///\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT32                          ControllerNumber;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Controller number.\r
+  ///\r
+  UINT32                      ControllerNumber;\r
 } CONTROLLER_DEVICE_PATH;\r
 \r
-//\r
-// ACPI Device Paths\r
-//\r
-#define ACPI_DEVICE_PATH          0x02\r
+///\r
+/// BMC Device Path SubType.\r
+///\r
+#define HW_BMC_DP  0x06\r
 \r
-#define ACPI_DP                   0x01\r
+///\r
+/// BMC Device Path.\r
+///\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT32                          HID;\r
-  UINT32                          UID;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Interface Type.\r
+  ///\r
+  UINT8                       InterfaceType;\r
+  ///\r
+  /// Base Address.\r
+  ///\r
+  UINT8                       BaseAddress[8];\r
+} BMC_DEVICE_PATH;\r
+\r
+///\r
+/// ACPI Device Paths.\r
+///\r
+#define ACPI_DEVICE_PATH  0x02\r
+\r
+///\r
+/// ACPI Device Path SubType.\r
+///\r
+#define ACPI_DP  0x01\r
+typedef struct {\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Device's PnP hardware ID stored in a numeric 32-bit\r
+  /// compressed EISA-type ID. This value must match the\r
+  /// corresponding _HID in the ACPI name space.\r
+  ///\r
+  UINT32                      HID;\r
+  ///\r
+  /// Unique ID that is required by ACPI if two devices have the\r
+  /// same _HID. This value must also match the corresponding\r
+  /// _UID/_HID pair in the ACPI name space. Only the 32-bit\r
+  /// numeric value type of _UID is supported. Thus, strings must\r
+  /// not be used for the _UID in the ACPI name space.\r
+  ///\r
+  UINT32                      UID;\r
 } ACPI_HID_DEVICE_PATH;\r
 \r
-#define ACPI_EXTENDED_DP          0x02\r
+///\r
+/// Expanded ACPI Device Path SubType.\r
+///\r
+#define ACPI_EXTENDED_DP  0x02\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT32                          HID;\r
-  UINT32                          UID;\r
-  UINT32                          CID;\r
-  //\r
-  // Optional variable length _HIDSTR\r
-  // Optional variable length _UIDSTR\r
-  //\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Device's PnP hardware ID stored in a numeric 32-bit\r
+  /// compressed EISA-type ID. This value must match the\r
+  /// corresponding _HID in the ACPI name space.\r
+  ///\r
+  UINT32                      HID;\r
+  ///\r
+  /// Unique ID that is required by ACPI if two devices have the\r
+  /// same _HID. This value must also match the corresponding\r
+  /// _UID/_HID pair in the ACPI name space.\r
+  ///\r
+  UINT32                      UID;\r
+  ///\r
+  /// Device's compatible PnP hardware ID stored in a numeric\r
+  /// 32-bit compressed EISA-type ID. This value must match at\r
+  /// least one of the compatible device IDs returned by the\r
+  /// corresponding _CID in the ACPI name space.\r
+  ///\r
+  UINT32                      CID;\r
+  ///\r
+  /// Optional variable length _HIDSTR.\r
+  /// Optional variable length _UIDSTR.\r
+  /// Optional variable length _CIDSTR.\r
+  ///\r
 } ACPI_EXTENDED_HID_DEVICE_PATH;\r
 \r
 //\r
@@ -120,141 +250,434 @@ typedef struct {
 //   bits[31:16] - binary number\r
 //    Compressed ASCII is 5 bits per character 0b00001 = 'A' 0b11010 = 'Z'\r
 //\r
-#define PNP_EISA_ID_CONST         0x41d0\r
-#define EISA_ID(_Name, _Num)      ((UINT32) ((_Name) | (_Num) << 16))\r
-#define EISA_PNP_ID(_PNPId)       (EISA_ID(PNP_EISA_ID_CONST, (_PNPId)))\r
-#define EFI_PNP_ID(_PNPId)        (EISA_ID(PNP_EISA_ID_CONST, (_PNPId)))\r
-\r
-#define PNP_EISA_ID_MASK          0xffff\r
-#define EISA_ID_TO_NUM(_Id)       ((_Id) >> 16)\r
-\r
-\r
-#define ACPI_ADR_DP               0x03\r
+#define PNP_EISA_ID_CONST  0x41d0\r
+#define EISA_ID(_Name, _Num)  ((UINT32)((_Name) | (_Num) << 16))\r
+#define EISA_PNP_ID(_PNPId)   (EISA_ID(PNP_EISA_ID_CONST, (_PNPId)))\r
+#define EFI_PNP_ID(_PNPId)    (EISA_ID(PNP_EISA_ID_CONST, (_PNPId)))\r
+\r
+#define PNP_EISA_ID_MASK  0xffff\r
+#define EISA_ID_TO_NUM(_Id)  ((_Id) >> 16)\r
+\r
+///\r
+/// ACPI _ADR Device Path SubType.\r
+///\r
+#define ACPI_ADR_DP  0x03\r
+\r
+///\r
+/// The _ADR device path is used to contain video output device attributes to support the Graphics\r
+/// Output Protocol. The device path can contain multiple _ADR entries if multiple video output\r
+/// devices are displaying the same output.\r
+///\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT32                          ADR;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// _ADR value. For video output devices the value of this\r
+  /// field comes from Table B-2 of the ACPI 3.0 specification. At\r
+  /// least one _ADR value is required.\r
+  ///\r
+  UINT32                      ADR;\r
+  //\r
+  // This device path may optionally contain more than one _ADR entry.\r
+  //\r
 } ACPI_ADR_DEVICE_PATH;\r
 \r
-\r
-//\r
-// Messaging Device Paths\r
-//\r
-#define MESSAGING_DEVICE_PATH     0x03\r
-\r
-#define MSG_ATAPI_DP              0x01\r
+///\r
+/// ACPI NVDIMM Device Path SubType.\r
+///\r
+#define ACPI_NVDIMM_DP  0x04\r
+///\r
+///\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT8                           PrimarySecondary;\r
-  UINT8                           SlaveMaster;\r
-  UINT16                          Lun;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// NFIT Device Handle, the _ADR of the NVDIMM device.\r
+  /// The value of this field comes from Section 9.20.3 of the ACPI 6.2A specification.\r
+  ///\r
+  UINT32                      NFITDeviceHandle;\r
+} ACPI_NVDIMM_DEVICE_PATH;\r
+\r
+#define ACPI_ADR_DISPLAY_TYPE_OTHER             0\r
+#define ACPI_ADR_DISPLAY_TYPE_VGA               1\r
+#define ACPI_ADR_DISPLAY_TYPE_TV                2\r
+#define ACPI_ADR_DISPLAY_TYPE_EXTERNAL_DIGITAL  3\r
+#define ACPI_ADR_DISPLAY_TYPE_INTERNAL_DIGITAL  4\r
+\r
+#define ACPI_DISPLAY_ADR(_DeviceIdScheme, _HeadId, _NonVgaOutput, _BiosCanDetect, _VendorInfo, _Type, _Port, _Index) \\r
+          ((UINT32)(  ((UINT32)((_DeviceIdScheme) & 0x1) << 31) |  \\r
+                      (((_HeadId)                 & 0x7) << 18) |  \\r
+                      (((_NonVgaOutput)           & 0x1) << 17) |  \\r
+                      (((_BiosCanDetect)          & 0x1) << 16) |  \\r
+                      (((_VendorInfo)             & 0xf) << 12) |  \\r
+                      (((_Type)                   & 0xf) << 8)  |  \\r
+                      (((_Port)                   & 0xf) << 4)  |  \\r
+                       ((_Index)                  & 0xf) ))\r
+\r
+///\r
+/// Messaging Device Paths.\r
+/// This Device Path is used to describe the connection of devices outside the resource domain of the\r
+/// system. This Device Path can describe physical messaging information like SCSI ID, or abstract\r
+/// information like networking protocol IP addresses.\r
+///\r
+#define MESSAGING_DEVICE_PATH  0x03\r
+\r
+///\r
+/// ATAPI Device Path SubType\r
+///\r
+#define MSG_ATAPI_DP  0x01\r
+typedef struct {\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Set to zero for primary, or one for secondary.\r
+  ///\r
+  UINT8                       PrimarySecondary;\r
+  ///\r
+  /// Set to zero for master, or one for slave mode.\r
+  ///\r
+  UINT8                       SlaveMaster;\r
+  ///\r
+  /// Logical Unit Number.\r
+  ///\r
+  UINT16                      Lun;\r
 } ATAPI_DEVICE_PATH;\r
 \r
-#define MSG_SCSI_DP               0x02\r
+///\r
+/// SCSI Device Path SubType.\r
+///\r
+#define MSG_SCSI_DP  0x02\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT16                          Pun;\r
-  UINT16                          Lun;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Target ID on the SCSI bus (PUN).\r
+  ///\r
+  UINT16                      Pun;\r
+  ///\r
+  /// Logical Unit Number (LUN).\r
+  ///\r
+  UINT16                      Lun;\r
 } SCSI_DEVICE_PATH;\r
 \r
-#define MSG_FIBRECHANNEL_DP       0x03\r
+///\r
+/// Fibre Channel SubType.\r
+///\r
+#define MSG_FIBRECHANNEL_DP  0x03\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT32                          Reserved;\r
-  UINT64                          WWN;\r
-  UINT64                          Lun;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Reserved for the future.\r
+  ///\r
+  UINT32                      Reserved;\r
+  ///\r
+  /// Fibre Channel World Wide Number.\r
+  ///\r
+  UINT64                      WWN;\r
+  ///\r
+  /// Fibre Channel Logical Unit Number.\r
+  ///\r
+  UINT64                      Lun;\r
 } FIBRECHANNEL_DEVICE_PATH;\r
 \r
-#define MSG_1394_DP               0x04\r
+///\r
+/// Fibre Channel Ex SubType.\r
+///\r
+#define MSG_FIBRECHANNELEX_DP  0x15\r
+typedef struct {\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Reserved for the future.\r
+  ///\r
+  UINT32                      Reserved;\r
+  ///\r
+  /// 8 byte array containing Fibre Channel End Device Port Name.\r
+  ///\r
+  UINT8                       WWN[8];\r
+  ///\r
+  /// 8 byte array containing Fibre Channel Logical Unit Number.\r
+  ///\r
+  UINT8                       Lun[8];\r
+} FIBRECHANNELEX_DEVICE_PATH;\r
+\r
+///\r
+/// 1394 Device Path SubType\r
+///\r
+#define MSG_1394_DP  0x04\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT32                          Reserved;\r
-  UINT64                          Guid;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Reserved for the future.\r
+  ///\r
+  UINT32                      Reserved;\r
+  ///\r
+  /// 1394 Global Unique ID (GUID).\r
+  ///\r
+  UINT64                      Guid;\r
 } F1394_DEVICE_PATH;\r
 \r
-#define MSG_USB_DP                0x05\r
+///\r
+/// USB Device Path SubType.\r
+///\r
+#define MSG_USB_DP  0x05\r
 typedef struct {\r
-    EFI_DEVICE_PATH_PROTOCOL      Header;\r
-    UINT8                         ParentPortNumber;\r
-    UINT8                         InterfaceNumber;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// USB Parent Port Number.\r
+  ///\r
+  UINT8                       ParentPortNumber;\r
+  ///\r
+  /// USB Interface Number.\r
+  ///\r
+  UINT8                       InterfaceNumber;\r
 } USB_DEVICE_PATH;\r
 \r
-#define MSG_USB_CLASS_DP          0x0f\r
+///\r
+/// USB Class Device Path SubType.\r
+///\r
+#define MSG_USB_CLASS_DP  0x0f\r
 typedef struct {\r
-    EFI_DEVICE_PATH_PROTOCOL      Header;\r
-    UINT16                        VendorId;\r
-    UINT16                        ProductId;\r
-    UINT8                         DeviceClass;\r
-    UINT8                         DeviceSubClass;\r
-    UINT8                         DeviceProtocol;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Vendor ID assigned by USB-IF. A value of 0xFFFF will\r
+  /// match any Vendor ID.\r
+  ///\r
+  UINT16                      VendorId;\r
+  ///\r
+  /// Product ID assigned by USB-IF. A value of 0xFFFF will\r
+  /// match any Product ID.\r
+  ///\r
+  UINT16                      ProductId;\r
+  ///\r
+  /// The class code assigned by the USB-IF. A value of 0xFF\r
+  /// will match any class code.\r
+  ///\r
+  UINT8                       DeviceClass;\r
+  ///\r
+  /// The subclass code assigned by the USB-IF. A value of\r
+  /// 0xFF will match any subclass code.\r
+  ///\r
+  UINT8                       DeviceSubClass;\r
+  ///\r
+  /// The protocol code assigned by the USB-IF. A value of\r
+  /// 0xFF will match any protocol code.\r
+  ///\r
+  UINT8                       DeviceProtocol;\r
 } USB_CLASS_DEVICE_PATH;\r
 \r
-#define MSG_USB_WWID_DP           0x10\r
+///\r
+/// USB WWID Device Path SubType.\r
+///\r
+#define MSG_USB_WWID_DP  0x10\r
+\r
+///\r
+/// This device path describes a USB device using its serial number.\r
+///\r
 typedef struct {\r
-    EFI_DEVICE_PATH_PROTOCOL      Header;\r
-    UINT16                        InterfaceNumber;\r
-    UINT16                        VendorId;\r
-    UINT16                        ProductId;\r
-    // CHAR16                     SerialNumber[...];\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// USB interface number.\r
+  ///\r
+  UINT16                      InterfaceNumber;\r
+  ///\r
+  /// USB vendor id of the device.\r
+  ///\r
+  UINT16                      VendorId;\r
+  ///\r
+  /// USB product id of the device.\r
+  ///\r
+  UINT16                      ProductId;\r
+  ///\r
+  /// Last 64-or-fewer UTF-16 characters of the USB\r
+  /// serial number. The length of the string is\r
+  /// determined by the Length field less the offset of the\r
+  /// Serial Number field (10)\r
+  ///\r
+  /// CHAR16                     SerialNumber[...];\r
 } USB_WWID_DEVICE_PATH;\r
 \r
-\r
+///\r
+/// Device Logical Unit SubType.\r
+///\r
 #define MSG_DEVICE_LOGICAL_UNIT_DP  0x11\r
 typedef struct {\r
-    EFI_DEVICE_PATH_PROTOCOL      Header;\r
-    UINT8                         Lun;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Logical Unit Number for the interface.\r
+  ///\r
+  UINT8                       Lun;\r
 } DEVICE_LOGICAL_UNIT_DEVICE_PATH;\r
 \r
-#define MSG_SATA_DP               0x12\r
+///\r
+/// SATA Device Path SubType.\r
+///\r
+#define MSG_SATA_DP  0x12\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT16                          HBAPortNumber;\r
-  UINT16                          PortMultiplierPortNumber;\r
-  UINT16                          Lun;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// The HBA port number that facilitates the connection to the\r
+  /// device or a port multiplier. The value 0xFFFF is reserved.\r
+  ///\r
+  UINT16                      HBAPortNumber;\r
+  ///\r
+  /// The Port multiplier port number that facilitates the connection\r
+  /// to the device. Must be set to 0xFFFF if the device is directly\r
+  /// connected to the HBA.\r
+  ///\r
+  UINT16                      PortMultiplierPortNumber;\r
+  ///\r
+  /// Logical Unit Number.\r
+  ///\r
+  UINT16                      Lun;\r
 } SATA_DEVICE_PATH;\r
 \r
-#define MSG_I2O_DP                0x06\r
+///\r
+/// Flag for if the device is directly connected to the HBA.\r
+///\r
+#define SATA_HBA_DIRECT_CONNECT_FLAG  0x8000\r
+\r
+///\r
+/// I2O Device Path SubType.\r
+///\r
+#define MSG_I2O_DP  0x06\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT32                          Tid;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Target ID (TID) for a device.\r
+  ///\r
+  UINT32                      Tid;\r
 } I2O_DEVICE_PATH;\r
 \r
-#define MSG_MAC_ADDR_DP           0x0b\r
+///\r
+/// MAC Address Device Path SubType.\r
+///\r
+#define MSG_MAC_ADDR_DP  0x0b\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  EFI_MAC_ADDRESS                 MacAddress;\r
-  UINT8                           IfType;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// The MAC address for a network interface padded with 0s.\r
+  ///\r
+  EFI_MAC_ADDRESS             MacAddress;\r
+  ///\r
+  /// Network interface type(i.e. 802.3, FDDI).\r
+  ///\r
+  UINT8                       IfType;\r
 } MAC_ADDR_DEVICE_PATH;\r
 \r
-#define MSG_IPv4_DP               0x0c\r
+///\r
+/// IPv4 Device Path SubType\r
+///\r
+#define MSG_IPv4_DP  0x0c\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  EFI_IPv4_ADDRESS                LocalIpAddress;\r
-  EFI_IPv4_ADDRESS                RemoteIpAddress;\r
-  UINT16                          LocalPort;\r
-  UINT16                          RemotePort;\r
-  UINT16                          Protocol;\r
-  BOOLEAN                         StaticIpAddress;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// The local IPv4 address.\r
+  ///\r
+  EFI_IPv4_ADDRESS            LocalIpAddress;\r
+  ///\r
+  /// The remote IPv4 address.\r
+  ///\r
+  EFI_IPv4_ADDRESS            RemoteIpAddress;\r
+  ///\r
+  /// The local port number.\r
+  ///\r
+  UINT16                      LocalPort;\r
+  ///\r
+  /// The remote port number.\r
+  ///\r
+  UINT16                      RemotePort;\r
+  ///\r
+  /// The network protocol(i.e. UDP, TCP).\r
+  ///\r
+  UINT16                      Protocol;\r
+  ///\r
+  /// 0x00 - The Source IP Address was assigned though DHCP.\r
+  /// 0x01 - The Source IP Address is statically bound.\r
+  ///\r
+  BOOLEAN                     StaticIpAddress;\r
+  ///\r
+  /// The gateway IP address\r
+  ///\r
+  EFI_IPv4_ADDRESS            GatewayIpAddress;\r
+  ///\r
+  /// The subnet mask\r
+  ///\r
+  EFI_IPv4_ADDRESS            SubnetMask;\r
 } IPv4_DEVICE_PATH;\r
 \r
-#define MSG_IPv6_DP               0x0d\r
+///\r
+/// IPv6 Device Path SubType.\r
+///\r
+#define MSG_IPv6_DP  0x0d\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  EFI_IPv6_ADDRESS                LocalIpAddress;\r
-  EFI_IPv6_ADDRESS                RemoteIpAddress;\r
-  UINT16                          LocalPort;\r
-  UINT16                          RemotePort;\r
-  UINT16                          Protocol;\r
-  BOOLEAN                         StaticIpAddress;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// The local IPv6 address.\r
+  ///\r
+  EFI_IPv6_ADDRESS            LocalIpAddress;\r
+  ///\r
+  /// The remote IPv6 address.\r
+  ///\r
+  EFI_IPv6_ADDRESS            RemoteIpAddress;\r
+  ///\r
+  /// The local port number.\r
+  ///\r
+  UINT16                      LocalPort;\r
+  ///\r
+  /// The remote port number.\r
+  ///\r
+  UINT16                      RemotePort;\r
+  ///\r
+  /// The network protocol(i.e. UDP, TCP).\r
+  ///\r
+  UINT16                      Protocol;\r
+  ///\r
+  /// 0x00 - The Local IP Address was manually configured.\r
+  /// 0x01 - The Local IP Address is assigned through IPv6\r
+  /// stateless auto-configuration.\r
+  /// 0x02 - The Local IP Address is assigned through IPv6\r
+  /// stateful configuration.\r
+  ///\r
+  UINT8                       IpAddressOrigin;\r
+  ///\r
+  /// The prefix length\r
+  ///\r
+  UINT8                       PrefixLength;\r
+  ///\r
+  /// The gateway IP address\r
+  ///\r
+  EFI_IPv6_ADDRESS            GatewayIpAddress;\r
 } IPv6_DEVICE_PATH;\r
 \r
-#define MSG_INFINIBAND_DP         0x09\r
+///\r
+/// InfiniBand Device Path SubType.\r
+///\r
+#define MSG_INFINIBAND_DP  0x09\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT32                          ResourceFlags;\r
-  UINT8                           PortGid[16];\r
-  UINT64                          ServiceId;\r
-  UINT64                          TargetPortId;\r
-  UINT64                          DeviceId;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Flags to help identify/manage InfiniBand device path elements:\r
+  /// Bit 0 - IOC/Service (0b = IOC, 1b = Service).\r
+  /// Bit 1 - Extend Boot Environment.\r
+  /// Bit 2 - Console Protocol.\r
+  /// Bit 3 - Storage Protocol.\r
+  /// Bit 4 - Network Protocol.\r
+  /// All other bits are reserved.\r
+  ///\r
+  UINT32    ResourceFlags;\r
+  ///\r
+  /// 128-bit Global Identifier for remote fabric port.\r
+  ///\r
+  UINT8     PortGid[16];\r
+  ///\r
+  /// 64-bit unique identifier to remote IOC or server process.\r
+  /// Interpretation of field specified by Resource Flags (bit 0).\r
+  ///\r
+  UINT64    ServiceId;\r
+  ///\r
+  /// 64-bit persistent ID of remote IOC port.\r
+  ///\r
+  UINT64    TargetPortId;\r
+  ///\r
+  /// 64-bit persistent ID of remote device.\r
+  ///\r
+  UINT64    DeviceId;\r
 } INFINIBAND_DEVICE_PATH;\r
 \r
 #define INFINIBAND_RESOURCE_FLAG_IOC_SERVICE                0x01\r
@@ -263,283 +686,690 @@ typedef struct {
 #define INFINIBAND_RESOURCE_FLAG_STORAGE_PROTOCOL           0x08\r
 #define INFINIBAND_RESOURCE_FLAG_NETWORK_PROTOCOL           0x10\r
 \r
-#define MSG_UART_DP               0x0e\r
+///\r
+/// UART Device Path SubType.\r
+///\r
+#define MSG_UART_DP  0x0e\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT32                          Reserved;\r
-  UINT64                          BaudRate;\r
-  UINT8                           DataBits;\r
-  UINT8                           Parity;\r
-  UINT8                           StopBits;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Reserved.\r
+  ///\r
+  UINT32                      Reserved;\r
+  ///\r
+  /// The baud rate setting for the UART style device. A value of 0\r
+  /// means that the device's default baud rate will be used.\r
+  ///\r
+  UINT64                      BaudRate;\r
+  ///\r
+  /// The number of data bits for the UART style device. A value\r
+  /// of 0 means that the device's default number of data bits will be used.\r
+  ///\r
+  UINT8                       DataBits;\r
+  ///\r
+  /// The parity setting for the UART style device.\r
+  /// Parity 0x00 - Default Parity.\r
+  /// Parity 0x01 - No Parity.\r
+  /// Parity 0x02 - Even Parity.\r
+  /// Parity 0x03 - Odd Parity.\r
+  /// Parity 0x04 - Mark Parity.\r
+  /// Parity 0x05 - Space Parity.\r
+  ///\r
+  UINT8    Parity;\r
+  ///\r
+  /// The number of stop bits for the UART style device.\r
+  /// Stop Bits 0x00 - Default Stop Bits.\r
+  /// Stop Bits 0x01 - 1 Stop Bit.\r
+  /// Stop Bits 0x02 - 1.5 Stop Bits.\r
+  /// Stop Bits 0x03 - 2 Stop Bits.\r
+  ///\r
+  UINT8    StopBits;\r
 } UART_DEVICE_PATH;\r
 \r
+///\r
+/// NVDIMM Namespace Device Path SubType.\r
+///\r
+#define NVDIMM_NAMESPACE_DP  0x20\r
+typedef struct {\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Namespace unique label identifier UUID.\r
+  ///\r
+  EFI_GUID                    Uuid;\r
+} NVDIMM_NAMESPACE_DEVICE_PATH;\r
+\r
 //\r
 // Use VENDOR_DEVICE_PATH struct\r
 //\r
-#define MSG_VENDOR_DP             0x0a\r
-typedef VENDOR_DEVICE_PATH        VENDOR_DEFINED_DEVICE_PATH;\r
-\r
-#define DEVICE_PATH_MESSAGING_PC_ANSI     EFI_PC_ANSI_GUID\r
-#define DEVICE_PATH_MESSAGING_VT_100      EFI_VT_100_GUID\r
-#define DEVICE_PATH_MESSAGING_VT_100_PLUS EFI_VT_100_PLUS_GUID\r
-#define DEVICE_PATH_MESSAGING_VT_UTF8     EFI_VT_UTF8_GUID\r
-\r
-#define DEVICE_PATH_MESSAGING_UART_FLOW_CONTROL   EFI_UART_DEVICE_PATH_GUID\r
-\r
+#define MSG_VENDOR_DP  0x0a\r
+typedef VENDOR_DEVICE_PATH VENDOR_DEFINED_DEVICE_PATH;\r
+\r
+#define DEVICE_PATH_MESSAGING_PC_ANSI      EFI_PC_ANSI_GUID\r
+#define DEVICE_PATH_MESSAGING_VT_100       EFI_VT_100_GUID\r
+#define DEVICE_PATH_MESSAGING_VT_100_PLUS  EFI_VT_100_PLUS_GUID\r
+#define DEVICE_PATH_MESSAGING_VT_UTF8      EFI_VT_UTF8_GUID\r
+\r
+///\r
+/// A new device path node is defined to declare flow control characteristics.\r
+/// UART Flow Control Messaging Device Path\r
+///\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  EFI_GUID                        Guid;\r
-  UINT32                          FlowControlMap;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// DEVICE_PATH_MESSAGING_UART_FLOW_CONTROL GUID.\r
+  ///\r
+  EFI_GUID                    Guid;\r
+  ///\r
+  /// Bitmap of supported flow control types.\r
+  /// Bit 0 set indicates hardware flow control.\r
+  /// Bit 1 set indicates Xon/Xoff flow control.\r
+  /// All other bits are reserved and are clear.\r
+  ///\r
+  UINT32                      FlowControlMap;\r
 } UART_FLOW_CONTROL_DEVICE_PATH;\r
 \r
-#define DEVICE_PATH_MESSAGING_SAS                 EFI_SAS_DEVICE_PATH_GUID\r
+#define UART_FLOW_CONTROL_HARDWARE  0x00000001\r
+#define UART_FLOW_CONTROL_XON_XOFF  0x00000010\r
 \r
+#define DEVICE_PATH_MESSAGING_SAS  EFI_SAS_DEVICE_PATH_GUID\r
+///\r
+/// Serial Attached SCSI (SAS) Device Path.\r
+///\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  EFI_GUID                        Guid;\r
-  UINT32                          Reserved;\r
-  UINT64                          SasAddress;\r
-  UINT64                          Lun;\r
-  UINT16                          DeviceTopology;\r
-  UINT16                          RelativeTargetPort;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// DEVICE_PATH_MESSAGING_SAS GUID.\r
+  ///\r
+  EFI_GUID                    Guid;\r
+  ///\r
+  /// Reserved for future use.\r
+  ///\r
+  UINT32                      Reserved;\r
+  ///\r
+  /// SAS Address for Serial Attached SCSI Target.\r
+  ///\r
+  UINT64                      SasAddress;\r
+  ///\r
+  /// SAS Logical Unit Number.\r
+  ///\r
+  UINT64                      Lun;\r
+  ///\r
+  /// More Information about the device and its interconnect.\r
+  ///\r
+  UINT16                      DeviceTopology;\r
+  ///\r
+  /// Relative Target Port (RTP).\r
+  ///\r
+  UINT16                      RelativeTargetPort;\r
 } SAS_DEVICE_PATH;\r
 \r
-#define MSG_ISCSI_DP              0x13\r
+///\r
+/// Serial Attached SCSI (SAS) Ex Device Path SubType\r
+///\r
+#define MSG_SASEX_DP  0x16\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT16                          NetworkProtocol;\r
-  UINT16                          LoginOption;\r
-  UINT64                          Lun;\r
-  UINT16                          TargetPortalGroupTag;\r
-  // CHAR8                        iSCSI Target Name\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// 8-byte array of the SAS Address for Serial Attached SCSI Target Port.\r
+  ///\r
+  UINT8                       SasAddress[8];\r
+  ///\r
+  /// 8-byte array of the SAS Logical Unit Number.\r
+  ///\r
+  UINT8                       Lun[8];\r
+  ///\r
+  /// More Information about the device and its interconnect.\r
+  ///\r
+  UINT16                      DeviceTopology;\r
+  ///\r
+  /// Relative Target Port (RTP).\r
+  ///\r
+  UINT16                      RelativeTargetPort;\r
+} SASEX_DEVICE_PATH;\r
+\r
+///\r
+/// NvmExpress Namespace Device Path SubType.\r
+///\r
+#define MSG_NVME_NAMESPACE_DP  0x17\r
+typedef struct {\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  UINT32                      NamespaceId;\r
+  UINT64                      NamespaceUuid;\r
+} NVME_NAMESPACE_DEVICE_PATH;\r
+\r
+///\r
+/// DNS Device Path SubType\r
+///\r
+#define MSG_DNS_DP  0x1F\r
+typedef struct {\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Indicates the DNS server address is IPv4 or IPv6 address.\r
+  ///\r
+  UINT8                       IsIPv6;\r
+  ///\r
+  /// Instance of the DNS server address.\r
+  ///\r
+  EFI_IP_ADDRESS              DnsServerIp[];\r
+} DNS_DEVICE_PATH;\r
+\r
+///\r
+/// Uniform Resource Identifiers (URI) Device Path SubType\r
+///\r
+#define MSG_URI_DP  0x18\r
+typedef struct {\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Instance of the URI pursuant to RFC 3986.\r
+  ///\r
+  CHAR8                       Uri[];\r
+} URI_DEVICE_PATH;\r
+\r
+///\r
+/// Universal Flash Storage (UFS) Device Path SubType.\r
+///\r
+#define MSG_UFS_DP  0x19\r
+typedef struct {\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Target ID on the UFS bus (PUN).\r
+  ///\r
+  UINT8                       Pun;\r
+  ///\r
+  /// Logical Unit Number (LUN).\r
+  ///\r
+  UINT8                       Lun;\r
+} UFS_DEVICE_PATH;\r
+\r
+///\r
+/// SD (Secure Digital) Device Path SubType.\r
+///\r
+#define MSG_SD_DP  0x1A\r
+typedef struct {\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  UINT8                       SlotNumber;\r
+} SD_DEVICE_PATH;\r
+\r
+///\r
+/// EMMC (Embedded MMC) Device Path SubType.\r
+///\r
+#define MSG_EMMC_DP  0x1D\r
+typedef struct {\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  UINT8                       SlotNumber;\r
+} EMMC_DEVICE_PATH;\r
+\r
+///\r
+/// iSCSI Device Path SubType\r
+///\r
+#define MSG_ISCSI_DP  0x13\r
+typedef struct {\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Network Protocol (0 = TCP, 1+ = reserved).\r
+  ///\r
+  UINT16                      NetworkProtocol;\r
+  ///\r
+  /// iSCSI Login Options.\r
+  ///\r
+  UINT16                      LoginOption;\r
+  ///\r
+  /// iSCSI Logical Unit Number.\r
+  ///\r
+  UINT64                      Lun;\r
+  ///\r
+  /// iSCSI Target Portal group tag the initiator intends\r
+  /// to establish a session with.\r
+  ///\r
+  UINT16                      TargetPortalGroupTag;\r
+  ///\r
+  /// iSCSI NodeTarget Name. The length of the name\r
+  /// is determined by subtracting the offset of this field from Length.\r
+  ///\r
+  /// CHAR8                        iSCSI Target Name.\r
 } ISCSI_DEVICE_PATH;\r
 \r
-#define ISCSI_LOGIN_OPTION_NO_HEADER_DIGEST             0x0000\r
-#define ISCSI_LOGIN_OPTION_HEADER_DIGEST_USING_CRC32C   0x0002\r
-#define ISCSI_LOGIN_OPTION_NO_DATA_DIGEST               0x0000\r
-#define ISCSI_LOGIN_OPTION_DATA_DIGEST_USING_CRC32C     0x0008\r
-#define ISCSI_LOGIN_OPTION_AUTHMETHOD_CHAP              0x0000\r
-#define ISCSI_LOGIN_OPTION_AUTHMETHOD_NON               0x1000\r
-#define ISCSI_LOGIN_OPTION_CHAP_BI                      0x0000\r
-#define ISCSI_LOGIN_OPTION_CHAP_UNI                     0x2000\r
+#define ISCSI_LOGIN_OPTION_NO_HEADER_DIGEST            0x0000\r
+#define ISCSI_LOGIN_OPTION_HEADER_DIGEST_USING_CRC32C  0x0002\r
+#define ISCSI_LOGIN_OPTION_NO_DATA_DIGEST              0x0000\r
+#define ISCSI_LOGIN_OPTION_DATA_DIGEST_USING_CRC32C    0x0008\r
+#define ISCSI_LOGIN_OPTION_AUTHMETHOD_CHAP             0x0000\r
+#define ISCSI_LOGIN_OPTION_AUTHMETHOD_NON              0x1000\r
+#define ISCSI_LOGIN_OPTION_CHAP_BI                     0x0000\r
+#define ISCSI_LOGIN_OPTION_CHAP_UNI                    0x2000\r
+\r
+///\r
+/// VLAN Device Path SubType.\r
+///\r
+#define MSG_VLAN_DP  0x14\r
+typedef struct {\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// VLAN identifier (0-4094).\r
+  ///\r
+  UINT16                      VlanId;\r
+} VLAN_DEVICE_PATH;\r
+\r
+///\r
+/// Bluetooth Device Path SubType.\r
+///\r
+#define MSG_BLUETOOTH_DP  0x1b\r
+typedef struct {\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// 48bit Bluetooth device address.\r
+  ///\r
+  BLUETOOTH_ADDRESS           BD_ADDR;\r
+} BLUETOOTH_DEVICE_PATH;\r
+\r
+///\r
+/// Wi-Fi Device Path SubType.\r
+///\r
+#define MSG_WIFI_DP  0x1C\r
+typedef struct {\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Service set identifier. A 32-byte octets string.\r
+  ///\r
+  UINT8                       SSId[32];\r
+} WIFI_DEVICE_PATH;\r
+\r
+///\r
+/// Bluetooth LE Device Path SubType.\r
+///\r
+#define MSG_BLUETOOTH_LE_DP  0x1E\r
+typedef struct {\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  BLUETOOTH_LE_ADDRESS        Address;\r
+} BLUETOOTH_LE_DEVICE_PATH;\r
 \r
 //\r
 // Media Device Path\r
 //\r
-#define MEDIA_DEVICE_PATH         0x04\r
+#define MEDIA_DEVICE_PATH  0x04\r
+\r
+///\r
+/// Hard Drive Media Device Path SubType.\r
+///\r
+#define MEDIA_HARDDRIVE_DP  0x01\r
 \r
-#define MEDIA_HARDDRIVE_DP        0x01\r
+///\r
+/// The Hard Drive Media Device Path is used to represent a partition on a hard drive.\r
+///\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT32                          PartitionNumber;\r
-  UINT64                          PartitionStart;\r
-  UINT64                          PartitionSize;\r
-  UINT8                           Signature[16];\r
-  UINT8                           MBRType;\r
-  UINT8                           SignatureType;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Describes the entry in a partition table, starting with entry 1.\r
+  /// Partition number zero represents the entire device. Valid\r
+  /// partition numbers for a MBR partition are [1, 4]. Valid\r
+  /// partition numbers for a GPT partition are [1, NumberOfPartitionEntries].\r
+  ///\r
+  UINT32                      PartitionNumber;\r
+  ///\r
+  /// Starting LBA of the partition on the hard drive.\r
+  ///\r
+  UINT64                      PartitionStart;\r
+  ///\r
+  /// Size of the partition in units of Logical Blocks.\r
+  ///\r
+  UINT64                      PartitionSize;\r
+  ///\r
+  /// Signature unique to this partition:\r
+  /// If SignatureType is 0, this field has to be initialized with 16 zeros.\r
+  /// If SignatureType is 1, the MBR signature is stored in the first 4 bytes of this field.\r
+  /// The other 12 bytes are initialized with zeros.\r
+  /// If SignatureType is 2, this field contains a 16 byte signature.\r
+  ///\r
+  UINT8                       Signature[16];\r
+  ///\r
+  /// Partition Format: (Unused values reserved).\r
+  /// 0x01 - PC-AT compatible legacy MBR.\r
+  /// 0x02 - GUID Partition Table.\r
+  ///\r
+  UINT8                       MBRType;\r
+  ///\r
+  /// Type of Disk Signature: (Unused values reserved).\r
+  /// 0x00 - No Disk Signature.\r
+  /// 0x01 - 32-bit signature from address 0x1b8 of the type 0x01 MBR.\r
+  /// 0x02 - GUID signature.\r
+  ///\r
+  UINT8                       SignatureType;\r
 } HARDDRIVE_DEVICE_PATH;\r
 \r
-#define MBR_TYPE_PCAT             0x01\r
-#define MBR_TYPE_EFI_PARTITION_TABLE_HEADER 0x02\r
+#define MBR_TYPE_PCAT                        0x01\r
+#define MBR_TYPE_EFI_PARTITION_TABLE_HEADER  0x02\r
+\r
+#define NO_DISK_SIGNATURE    0x00\r
+#define SIGNATURE_TYPE_MBR   0x01\r
+#define SIGNATURE_TYPE_GUID  0x02\r
 \r
-#define SIGNATURE_TYPE_MBR        0x01\r
-#define SIGNATURE_TYPE_GUID       0x02\r
+///\r
+/// CD-ROM Media Device Path SubType.\r
+///\r
+#define MEDIA_CDROM_DP  0x02\r
 \r
-#define MEDIA_CDROM_DP            0x02\r
+///\r
+/// The CD-ROM Media Device Path is used to define a system partition that exists on a CD-ROM.\r
+///\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT32                          BootEntry;\r
-  UINT64                          PartitionStart;\r
-  UINT64                          PartitionSize;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Boot Entry number from the Boot Catalog. The Initial/Default entry is defined as zero.\r
+  ///\r
+  UINT32                      BootEntry;\r
+  ///\r
+  /// Starting RBA of the partition on the medium. CD-ROMs use Relative logical Block Addressing.\r
+  ///\r
+  UINT64                      PartitionStart;\r
+  ///\r
+  /// Size of the partition in units of Blocks, also called Sectors.\r
+  ///\r
+  UINT64                      PartitionSize;\r
 } CDROM_DEVICE_PATH;\r
 \r
 //\r
 // Use VENDOR_DEVICE_PATH struct\r
 //\r
-#define MEDIA_VENDOR_DP           0x03\r
+#define MEDIA_VENDOR_DP  0x03           ///< Media vendor device path subtype.\r
 \r
-#define MEDIA_FILEPATH_DP         0x04\r
+///\r
+/// File Path Media Device Path SubType\r
+///\r
+#define MEDIA_FILEPATH_DP  0x04\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  CHAR16                          PathName[1];\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// A NULL-terminated Path string including directory and file names.\r
+  ///\r
+  CHAR16                      PathName[1];\r
 } FILEPATH_DEVICE_PATH;\r
 \r
-#define SIZE_OF_FILEPATH_DEVICE_PATH  EFI_FIELD_OFFSET(FILEPATH_DEVICE_PATH,PathName)\r
+#define SIZE_OF_FILEPATH_DEVICE_PATH  OFFSET_OF(FILEPATH_DEVICE_PATH,PathName)\r
 \r
-#define MEDIA_PROTOCOL_DP         0x05\r
+///\r
+/// Media Protocol Device Path SubType.\r
+///\r
+#define MEDIA_PROTOCOL_DP  0x05\r
+\r
+///\r
+/// The Media Protocol Device Path is used to denote the protocol that is being\r
+/// used in a device path at the location of the path specified.\r
+/// Many protocols are inherent to the style of device path.\r
+///\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  EFI_GUID                        Protocol;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// The ID of the protocol.\r
+  ///\r
+  EFI_GUID                    Protocol;\r
 } MEDIA_PROTOCOL_DEVICE_PATH;\r
 \r
+///\r
+/// PIWG Firmware File SubType.\r
+///\r
+#define MEDIA_PIWG_FW_FILE_DP  0x06\r
+\r
+///\r
+/// This device path is used by systems implementing the UEFI PI Specification 1.0 to describe a firmware file.\r
+///\r
+typedef struct {\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Firmware file name\r
+  ///\r
+  EFI_GUID                    FvFileName;\r
+} MEDIA_FW_VOL_FILEPATH_DEVICE_PATH;\r
+\r
+///\r
+/// PIWG Firmware Volume Device Path SubType.\r
+///\r
+#define MEDIA_PIWG_FW_VOL_DP  0x07\r
 \r
-#define MEDIA_PIWG_FW_VOL_DP      0x6\r
+///\r
+/// This device path is used by systems implementing the UEFI PI Specification 1.0 to describe a firmware volume.\r
+///\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  EFI_GUID                        FvName;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Firmware volume name.\r
+  ///\r
+  EFI_GUID                    FvName;\r
 } MEDIA_FW_VOL_DEVICE_PATH;\r
 \r
+///\r
+/// Media relative offset range device path.\r
+///\r
+#define MEDIA_RELATIVE_OFFSET_RANGE_DP  0x08\r
 \r
-#define MEDIA_PIWG_FW_FILE_DP     0x7\r
+///\r
+/// Used to describe the offset range of media relative.\r
+///\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  EFI_GUID                        FvFileName;\r
-} MEDIA_FW_VOL_FILEPATH_DEVICE_PATH;\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  UINT32                      Reserved;\r
+  UINT64                      StartingOffset;\r
+  UINT64                      EndingOffset;\r
+} MEDIA_RELATIVE_OFFSET_RANGE_DEVICE_PATH;\r
 \r
-//\r
-// BBS Device Path\r
-//\r
-#define BBS_DEVICE_PATH           0x05\r
-#define BBS_BBS_DP                0x01\r
+///\r
+/// This GUID defines a RAM Disk supporting a raw disk format in volatile memory.\r
+///\r
+#define EFI_VIRTUAL_DISK_GUID  EFI_ACPI_6_0_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_DISK_REGION_VOLATILE\r
+\r
+extern  EFI_GUID  gEfiVirtualDiskGuid;\r
+\r
+///\r
+/// This GUID defines a RAM Disk supporting an ISO image in volatile memory.\r
+///\r
+#define EFI_VIRTUAL_CD_GUID  EFI_ACPI_6_0_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_CD_REGION_VOLATILE\r
+\r
+extern  EFI_GUID  gEfiVirtualCdGuid;\r
+\r
+///\r
+/// This GUID defines a RAM Disk supporting a raw disk format in persistent memory.\r
+///\r
+#define EFI_PERSISTENT_VIRTUAL_DISK_GUID  EFI_ACPI_6_0_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_DISK_REGION_PERSISTENT\r
+\r
+extern  EFI_GUID  gEfiPersistentVirtualDiskGuid;\r
+\r
+///\r
+/// This GUID defines a RAM Disk supporting an ISO image in persistent memory.\r
+///\r
+#define EFI_PERSISTENT_VIRTUAL_CD_GUID  EFI_ACPI_6_0_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_CD_REGION_PERSISTENT\r
+\r
+extern  EFI_GUID  gEfiPersistentVirtualCdGuid;\r
+\r
+///\r
+/// Media ram disk device path.\r
+///\r
+#define MEDIA_RAM_DISK_DP  0x09\r
+\r
+///\r
+/// Used to describe the ram disk device path.\r
+///\r
 typedef struct {\r
-  EFI_DEVICE_PATH_PROTOCOL        Header;\r
-  UINT16                          DeviceType;\r
-  UINT16                          StatusFlag;\r
-  CHAR8                           String[1];\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Starting Memory Address.\r
+  ///\r
+  UINT32                      StartingAddr[2];\r
+  ///\r
+  /// Ending Memory Address.\r
+  ///\r
+  UINT32                      EndingAddr[2];\r
+  ///\r
+  /// GUID that defines the type of the RAM Disk.\r
+  ///\r
+  EFI_GUID                    TypeGuid;\r
+  ///\r
+  /// RAM Diskinstance number, if supported. The default value is zero.\r
+  ///\r
+  UINT16                      Instance;\r
+} MEDIA_RAM_DISK_DEVICE_PATH;\r
+\r
+///\r
+/// BIOS Boot Specification Device Path.\r
+///\r
+#define BBS_DEVICE_PATH  0x05\r
+\r
+///\r
+/// BIOS Boot Specification Device Path SubType.\r
+///\r
+#define BBS_BBS_DP  0x01\r
+\r
+///\r
+/// This Device Path is used to describe the booting of non-EFI-aware operating systems.\r
+///\r
+typedef struct {\r
+  EFI_DEVICE_PATH_PROTOCOL    Header;\r
+  ///\r
+  /// Device Type as defined by the BIOS Boot Specification.\r
+  ///\r
+  UINT16                      DeviceType;\r
+  ///\r
+  /// Status Flags as defined by the BIOS Boot Specification.\r
+  ///\r
+  UINT16                      StatusFlag;\r
+  ///\r
+  /// Null-terminated ASCII string that describes the boot device to a user.\r
+  ///\r
+  CHAR8                       String[1];\r
 } BBS_BBS_DEVICE_PATH;\r
 \r
 //\r
 // DeviceType definitions - from BBS specification\r
 //\r
-#define BBS_TYPE_FLOPPY           0x01\r
-#define BBS_TYPE_HARDDRIVE        0x02\r
-#define BBS_TYPE_CDROM            0x03\r
-#define BBS_TYPE_PCMCIA           0x04\r
-#define BBS_TYPE_USB              0x05\r
-#define BBS_TYPE_EMBEDDED_NETWORK 0x06\r
-#define BBS_TYPE_BEV              0x80\r
-#define BBS_TYPE_UNKNOWN          0xFF\r
-\r
-\r
-//\r
-// Union of all possible Device Paths and pointers to Device Paths\r
-//\r
-\r
+#define BBS_TYPE_FLOPPY            0x01\r
+#define BBS_TYPE_HARDDRIVE         0x02\r
+#define BBS_TYPE_CDROM             0x03\r
+#define BBS_TYPE_PCMCIA            0x04\r
+#define BBS_TYPE_USB               0x05\r
+#define BBS_TYPE_EMBEDDED_NETWORK  0x06\r
+#define BBS_TYPE_BEV               0x80\r
+#define BBS_TYPE_UNKNOWN           0xFF\r
+\r
+///\r
+/// Union of all possible Device Paths and pointers to Device Paths.\r
+///\r
 typedef union {\r
-  EFI_DEVICE_PATH_PROTOCOL             DevPath;\r
-  PCI_DEVICE_PATH                      Pci;\r
-  PCCARD_DEVICE_PATH                   PcCard;\r
-  MEMMAP_DEVICE_PATH                   MemMap;\r
-  VENDOR_DEVICE_PATH                   Vendor;\r
-\r
-  CONTROLLER_DEVICE_PATH               Controller;\r
-  ACPI_HID_DEVICE_PATH                 Acpi;\r
-\r
-  ATAPI_DEVICE_PATH                    Atapi;\r
-  SCSI_DEVICE_PATH                     Scsi;\r
-  ISCSI_DEVICE_PATH                    Iscsi;\r
-  FIBRECHANNEL_DEVICE_PATH             FibreChannel;\r
-\r
-  F1394_DEVICE_PATH                    F1394;\r
-  USB_DEVICE_PATH                      Usb;\r
-  SATA_DEVICE_PATH                     Sata;\r
-  USB_CLASS_DEVICE_PATH                UsbClass;\r
-  I2O_DEVICE_PATH                      I2O;\r
-  MAC_ADDR_DEVICE_PATH                 MacAddr;\r
-  IPv4_DEVICE_PATH                     Ipv4;\r
-  IPv6_DEVICE_PATH                     Ipv6;\r
-  INFINIBAND_DEVICE_PATH               InfiniBand;\r
-  UART_DEVICE_PATH                     Uart;\r
-\r
-  HARDDRIVE_DEVICE_PATH                HardDrive;\r
-  CDROM_DEVICE_PATH                    CD;\r
-\r
-  FILEPATH_DEVICE_PATH                 FilePath;\r
-  MEDIA_PROTOCOL_DEVICE_PATH           MediaProtocol;\r
-\r
-  BBS_BBS_DEVICE_PATH                  Bbs;\r
+  EFI_DEVICE_PATH_PROTOCOL                   DevPath;\r
+  PCI_DEVICE_PATH                            Pci;\r
+  PCCARD_DEVICE_PATH                         PcCard;\r
+  MEMMAP_DEVICE_PATH                         MemMap;\r
+  VENDOR_DEVICE_PATH                         Vendor;\r
+\r
+  CONTROLLER_DEVICE_PATH                     Controller;\r
+  BMC_DEVICE_PATH                            Bmc;\r
+  ACPI_HID_DEVICE_PATH                       Acpi;\r
+  ACPI_EXTENDED_HID_DEVICE_PATH              ExtendedAcpi;\r
+  ACPI_ADR_DEVICE_PATH                       AcpiAdr;\r
+\r
+  ATAPI_DEVICE_PATH                          Atapi;\r
+  SCSI_DEVICE_PATH                           Scsi;\r
+  ISCSI_DEVICE_PATH                          Iscsi;\r
+  FIBRECHANNEL_DEVICE_PATH                   FibreChannel;\r
+  FIBRECHANNELEX_DEVICE_PATH                 FibreChannelEx;\r
+\r
+  F1394_DEVICE_PATH                          F1394;\r
+  USB_DEVICE_PATH                            Usb;\r
+  SATA_DEVICE_PATH                           Sata;\r
+  USB_CLASS_DEVICE_PATH                      UsbClass;\r
+  USB_WWID_DEVICE_PATH                       UsbWwid;\r
+  DEVICE_LOGICAL_UNIT_DEVICE_PATH            LogicUnit;\r
+  I2O_DEVICE_PATH                            I2O;\r
+  MAC_ADDR_DEVICE_PATH                       MacAddr;\r
+  IPv4_DEVICE_PATH                           Ipv4;\r
+  IPv6_DEVICE_PATH                           Ipv6;\r
+  VLAN_DEVICE_PATH                           Vlan;\r
+  INFINIBAND_DEVICE_PATH                     InfiniBand;\r
+  UART_DEVICE_PATH                           Uart;\r
+  UART_FLOW_CONTROL_DEVICE_PATH              UartFlowControl;\r
+  SAS_DEVICE_PATH                            Sas;\r
+  SASEX_DEVICE_PATH                          SasEx;\r
+  NVME_NAMESPACE_DEVICE_PATH                 NvmeNamespace;\r
+  DNS_DEVICE_PATH                            Dns;\r
+  URI_DEVICE_PATH                            Uri;\r
+  BLUETOOTH_DEVICE_PATH                      Bluetooth;\r
+  WIFI_DEVICE_PATH                           WiFi;\r
+  UFS_DEVICE_PATH                            Ufs;\r
+  SD_DEVICE_PATH                             Sd;\r
+  EMMC_DEVICE_PATH                           Emmc;\r
+  HARDDRIVE_DEVICE_PATH                      HardDrive;\r
+  CDROM_DEVICE_PATH                          CD;\r
+\r
+  FILEPATH_DEVICE_PATH                       FilePath;\r
+  MEDIA_PROTOCOL_DEVICE_PATH                 MediaProtocol;\r
+\r
+  MEDIA_FW_VOL_DEVICE_PATH                   FirmwareVolume;\r
+  MEDIA_FW_VOL_FILEPATH_DEVICE_PATH          FirmwareFile;\r
+  MEDIA_RELATIVE_OFFSET_RANGE_DEVICE_PATH    Offset;\r
+  MEDIA_RAM_DISK_DEVICE_PATH                 RamDisk;\r
+  BBS_BBS_DEVICE_PATH                        Bbs;\r
 } EFI_DEV_PATH;\r
 \r
-\r
-\r
 typedef union {\r
-  EFI_DEVICE_PATH_PROTOCOL             *DevPath;\r
-  PCI_DEVICE_PATH                      *Pci;\r
-  PCCARD_DEVICE_PATH                   *PcCard;\r
-  MEMMAP_DEVICE_PATH                   *MemMap;\r
-  VENDOR_DEVICE_PATH                   *Vendor;\r
-\r
-  CONTROLLER_DEVICE_PATH               *Controller;\r
-  ACPI_HID_DEVICE_PATH                 *Acpi;\r
-  ACPI_EXTENDED_HID_DEVICE_PATH        *ExtendedAcpi;\r
-\r
-  ATAPI_DEVICE_PATH                    *Atapi;\r
-  SCSI_DEVICE_PATH                     *Scsi;\r
-  FIBRECHANNEL_DEVICE_PATH             *FibreChannel;\r
-\r
-  F1394_DEVICE_PATH                    *F1394;\r
-  USB_DEVICE_PATH                      *Usb;\r
-  SATA_DEVICE_PATH                     *Sata;\r
-  USB_CLASS_DEVICE_PATH                *UsbClass;\r
-  I2O_DEVICE_PATH                      *I2O;\r
-  MAC_ADDR_DEVICE_PATH                 *MacAddr;\r
-  IPv4_DEVICE_PATH                     *Ipv4;\r
-  IPv6_DEVICE_PATH                     *Ipv6;\r
-  INFINIBAND_DEVICE_PATH               *InfiniBand;\r
-  UART_DEVICE_PATH                     *Uart;\r
-\r
-  HARDDRIVE_DEVICE_PATH                *HardDrive;\r
-  CDROM_DEVICE_PATH                    *CD;\r
-\r
-  FILEPATH_DEVICE_PATH                 *FilePath;\r
-  MEDIA_PROTOCOL_DEVICE_PATH           *MediaProtocol;\r
-\r
-  BBS_BBS_DEVICE_PATH                  *Bbs;\r
-  UINT8                                *Raw;\r
+  EFI_DEVICE_PATH_PROTOCOL                   *DevPath;\r
+  PCI_DEVICE_PATH                            *Pci;\r
+  PCCARD_DEVICE_PATH                         *PcCard;\r
+  MEMMAP_DEVICE_PATH                         *MemMap;\r
+  VENDOR_DEVICE_PATH                         *Vendor;\r
+\r
+  CONTROLLER_DEVICE_PATH                     *Controller;\r
+  BMC_DEVICE_PATH                            *Bmc;\r
+  ACPI_HID_DEVICE_PATH                       *Acpi;\r
+  ACPI_EXTENDED_HID_DEVICE_PATH              *ExtendedAcpi;\r
+  ACPI_ADR_DEVICE_PATH                       *AcpiAdr;\r
+\r
+  ATAPI_DEVICE_PATH                          *Atapi;\r
+  SCSI_DEVICE_PATH                           *Scsi;\r
+  ISCSI_DEVICE_PATH                          *Iscsi;\r
+  FIBRECHANNEL_DEVICE_PATH                   *FibreChannel;\r
+  FIBRECHANNELEX_DEVICE_PATH                 *FibreChannelEx;\r
+\r
+  F1394_DEVICE_PATH                          *F1394;\r
+  USB_DEVICE_PATH                            *Usb;\r
+  SATA_DEVICE_PATH                           *Sata;\r
+  USB_CLASS_DEVICE_PATH                      *UsbClass;\r
+  USB_WWID_DEVICE_PATH                       *UsbWwid;\r
+  DEVICE_LOGICAL_UNIT_DEVICE_PATH            *LogicUnit;\r
+  I2O_DEVICE_PATH                            *I2O;\r
+  MAC_ADDR_DEVICE_PATH                       *MacAddr;\r
+  IPv4_DEVICE_PATH                           *Ipv4;\r
+  IPv6_DEVICE_PATH                           *Ipv6;\r
+  VLAN_DEVICE_PATH                           *Vlan;\r
+  INFINIBAND_DEVICE_PATH                     *InfiniBand;\r
+  UART_DEVICE_PATH                           *Uart;\r
+  UART_FLOW_CONTROL_DEVICE_PATH              *UartFlowControl;\r
+  SAS_DEVICE_PATH                            *Sas;\r
+  SASEX_DEVICE_PATH                          *SasEx;\r
+  NVME_NAMESPACE_DEVICE_PATH                 *NvmeNamespace;\r
+  DNS_DEVICE_PATH                            *Dns;\r
+  URI_DEVICE_PATH                            *Uri;\r
+  BLUETOOTH_DEVICE_PATH                      *Bluetooth;\r
+  WIFI_DEVICE_PATH                           *WiFi;\r
+  UFS_DEVICE_PATH                            *Ufs;\r
+  SD_DEVICE_PATH                             *Sd;\r
+  EMMC_DEVICE_PATH                           *Emmc;\r
+  HARDDRIVE_DEVICE_PATH                      *HardDrive;\r
+  CDROM_DEVICE_PATH                          *CD;\r
+\r
+  FILEPATH_DEVICE_PATH                       *FilePath;\r
+  MEDIA_PROTOCOL_DEVICE_PATH                 *MediaProtocol;\r
+\r
+  MEDIA_FW_VOL_DEVICE_PATH                   *FirmwareVolume;\r
+  MEDIA_FW_VOL_FILEPATH_DEVICE_PATH          *FirmwareFile;\r
+  MEDIA_RELATIVE_OFFSET_RANGE_DEVICE_PATH    *Offset;\r
+  MEDIA_RAM_DISK_DEVICE_PATH                 *RamDisk;\r
+  BBS_BBS_DEVICE_PATH                        *Bbs;\r
+  UINT8                                      *Raw;\r
 } EFI_DEV_PATH_PTR;\r
 \r
 #pragma pack()\r
-                                             \r
-#define EFI_DP_TYPE_MASK                     0x7F\r
-#define EFI_DP_TYPE_UNPACKED                 0x80\r
-#define END_DEVICE_PATH_TYPE                 0x7f\r
-                                             \r
-#define EFI_END_ENTIRE_DEVICE_PATH           0xff\r
-#define EFI_END_ENTIRE_DEVICE_PATH_SUBTYPE   0xff\r
-#define EFI_END_INSTANCE_DEVICE_PATH         0x01\r
-#define END_ENTIRE_DEVICE_PATH_SUBTYPE       EFI_END_ENTIRE_DEVICE_PATH_SUBTYPE\r
-#define END_INSTANCE_DEVICE_PATH_SUBTYPE     EFI_END_INSTANCE_DEVICE_PATH\r
-                                             \r
-#define EFI_END_DEVICE_PATH_LENGTH           (sizeof (EFI_DEVICE_PATH_PROTOCOL))\r
-#define END_DEVICE_PATH_LENGTH               EFI_END_DEVICE_PATH_LENGTH\r
-                                             \r
-#define DP_IS_END_TYPE(a)                    \r
-#define DP_IS_END_SUBTYPE(a)                 (((a)->SubType == END_ENTIRE_DEVICE_PATH_SUBTYPE)\r
-#define DevicePathSubType(a)                 ((a)->SubType)\r
-#define IsDevicePathUnpacked(a)              ((a)->Type & EFI_DP_TYPE_UNPACKED)\r
-                                             \r
-#define EfiDevicePathNodeLength(a)           (((a)->Length[0]) | ((a)->Length[1] << 8))\r
-#define DevicePathNodeLength(a)              (EfiDevicePathNodeLength(a))\r
-#define EfiNextDevicePathNode(a)             ((EFI_DEVICE_PATH_PROTOCOL *) (((UINT8 *) (a)) + EfiDevicePathNodeLength (a)))\r
-#define NextDevicePathNode(a)                (EfiNextDevicePathNode(a)) \r
-                                             \r
-#define EfiDevicePathType(a)                 (((a)->Type) & EFI_DP_TYPE_MASK)\r
-#define DevicePathType(a)                    (EfiDevicePathType(a))\r
-#define EfiIsDevicePathEndType(a)            (EfiDevicePathType (a) == END_DEVICE_PATH_TYPE)\r
-#define IsDevicePathEndType(a)               (EfiIsDevicePathEndType(a)) \r
-                                             \r
-                                             \r
-#define EfiIsDevicePathEndSubType(a)         ((a)->SubType == EFI_END_ENTIRE_DEVICE_PATH_SUBTYPE)\r
-#define IsDevicePathEndSubType(a)            (EfiIsDevicePathEndSubType(a))\r
-#define EfiIsDevicePathEndInstanceSubType(a) ((a)->SubType == EFI_END_INSTANCE_DEVICE_PATH)\r
-                                             \r
-#define EfiIsDevicePathEnd(a)                (EfiIsDevicePathEndType (a) && EfiIsDevicePathEndSubType (a))\r
-#define IsDevicePathEnd(a)                   (EfiIsDevicePathEnd(a))\r
-#define EfiIsDevicePathEndInstance(a)        (EfiIsDevicePathEndType (a) && EfiIsDevicePathEndInstanceSubType (a))\r
-\r
-\r
-#define SetDevicePathNodeLength(a,l) {                           \\r
-          (a)->Length[0] = (UINT8) (l);                          \\r
-          (a)->Length[1] = (UINT8) ((l) >> 8);                   \\r
-          }\r
-\r
-#define SetDevicePathEndNode(a)  {                               \\r
-          (a)->Type = END_DEVICE_PATH_TYPE;                      \\r
-          (a)->SubType = END_ENTIRE_DEVICE_PATH_SUBTYPE;         \\r
-          (a)->Length[0] = sizeof(EFI_DEVICE_PATH_PROTOCOL);     \\r
-          (a)->Length[1] = 0;                                    \\r
-          }\r
-\r
-extern EFI_GUID gEfiDevicePathProtocolGuid;\r
+\r
+#define END_DEVICE_PATH_TYPE              0x7f\r
+#define END_ENTIRE_DEVICE_PATH_SUBTYPE    0xFF\r
+#define END_INSTANCE_DEVICE_PATH_SUBTYPE  0x01\r
+\r
+extern EFI_GUID  gEfiDevicePathProtocolGuid;\r
 \r
 #endif\r