1 files changed, 23 insertions, 9 deletions
diff --git a/MdeModulePkg/Include/WorkingBlockHeader.h b/MdeModulePkg/Include/WorkingBlockHeader.h
index 1158e9a2c7..93a0c8d934 100644
--- a/MdeModulePkg/Include/WorkingBlockHeader.h
+++ b/MdeModulePkg/Include/WorkingBlockHeader.h
@@ -16,23 +16,37 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #ifndef __EFI_WORKING_BLOCK_HEADER_H__
 #define __EFI_WORKING_BLOCK_HEADER_H__
 
-//
-// EFI Fault tolerant working block header
-// The header is immediately followed by the write queue.
-//
+#define WORKING_BLOCK_VALID   0x1
+#define WORKING_BLOCK_INVALID 0x2
+
+///
+/// EFI Fault tolerant working block header
+/// The header is immediately followed by the write queue.
+///
 typedef struct {
+  ///
+  /// System Non Volatile FV Guid
+  ///
   EFI_GUID  Signature;
+  ///
+  /// 32bit CRC caculated for this header
+  ///
   UINT32    Crc;
+  ///
+  /// Working block valid bit
+  ///
   UINT8     WorkingBlockValid : 1;
   UINT8     WorkingBlockInvalid : 1;
-#define WORKING_BLOCK_VALID   0x1
-#define WORKING_BLOCK_INVALID 0x2
   UINT8     Reserved : 6;
   UINT8     Reserved3[3];
+  ///
+  /// Total size of the following write queue range.
+  ///
   UINT64    WriteQueueSize;
-  //
-  // UINT8                WriteQueue[WriteQueueSize];
-  //
+  ///
+  /// Write Queue data
+  /// UINT8                WriteQueue[WriteQueueSize];
+  ///
 } EFI_FAULT_TOLERANT_WORKING_BLOCK_HEADER;
 
 #endif