1 files changed, 12 insertions, 9 deletions
diff --git a/MdeModulePkg/Include/Guid/CapsuleVendor.h b/MdeModulePkg/Include/Guid/CapsuleVendor.h
index 5bbccd3652..b326018c49 100644
--- a/MdeModulePkg/Include/Guid/CapsuleVendor.h
+++ b/MdeModulePkg/Include/Guid/CapsuleVendor.h
@@ -1,7 +1,8 @@
 /** @file
 
-  This file defines capsule update guid, capsule variable name and 
-  capsule guid hob data structure, which are required by capsule update feature.
+  This file defines capsule vendor guid, capsule variable name 
+  and capsule guid hob data structure. 
+  They are used by EDKII implementation of capsule update across a system reset.
 
 Copyright (c) 2006 - 2008, Intel Corporation
 All rights reserved. This program and the accompanying materials
@@ -18,9 +19,11 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #define __EFI_CAPSULE_VENDOR_GUID_H__
 
 ///
-/// This guid is used as a variable GUID (depending on implementation)
-/// for the capsule variable if the capsule pointer is passes through reset
-/// via a variable.
+/// This guid is used as a variable GUID for the capsule variable 
+/// if the capsule pointer is passed through reset via a variable.
+///
+/// This guid is also used as a hob GUID for the capsule data 
+/// when the capsule pointer is passed from PEI phase to DXE phase.
 ///
 #define EFI_CAPSULE_VENDOR_GUID  \
   { 0x711C703F, 0xC285, 0x4B10, { 0xA3, 0xB0, 0x36, 0xEC, 0xBD, 0x3C, 0x8B, 0xE2 } }
@@ -30,14 +33,14 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 /// 
 #define EFI_CAPSULE_VARIABLE_NAME L"CapsuleUpdateData"
 
-extern EFI_GUID gEfiCapsuleVendorGuid;
-
 ///
 /// Data structure of capsule guid hob entry
 ///
 typedef struct {
-  EFI_PHYSICAL_ADDRESS BaseAddress;  /// Capsule data start address
-  UINT32 Length;                     /// Length of capsule data.
+  EFI_PHYSICAL_ADDRESS BaseAddress;  ///> Capsule data start address
+  UINT32 Length;                     ///> Length of capsule data.
 } CAPSULE_HOB_INFO;
 
+extern EFI_GUID gEfiCapsuleVendorGuid;
+
 #endif // #ifndef _EFI_CAPSULE_VENDOR_GUID_H_