]> git.proxmox.com Git - mirror_edk2.git/commitdiff
Make doxygen type comment for Nt32Pkg.dec file.
authorklu2 <klu2@6f19259b-4bc3-4df7-8a09-765794883524>
Fri, 11 Jul 2008 07:33:59 +0000 (07:33 +0000)
committerklu2 <klu2@6f19259b-4bc3-4df7-8a09-765794883524>
Fri, 11 Jul 2008 07:33:59 +0000 (07:33 +0000)
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@5454 6f19259b-4bc3-4df7-8a09-765794883524

Nt32Pkg/Nt32Pkg.dec

index c35a561a60f16594ed62c01a5e9bf82f540413d8..3db1c9fdc42867d7d843b19fd740b47fcbd99003 100644 (file)
@@ -1,62 +1,56 @@
-#/** @file\r
-# EFI/PI Reference Module Package for All Architectures\r
-#\r
-# This DEC file is used for Package Level build.\r
+## @file\r
+# This package is a platform package that provide platform module/library \r
+# required by NT32 platform.\r
+#\r
+# File/Directory Orignazation:\r
+# |- Sec            : Emulation SecCore for Nt32 platform\r
+# |- *Pei           : PEIM drivers\r
+# |- *Dxe           : DXE drivers\r
+# |- Nt32Pkg.dec    : This file\r
+# |- Nt32Pkg.dsc    : Nt32 platform DSC file\r
+# |- Nt32Pkg.fdf    : Flash description file for Nt32Pkg. It is used for creating FD file.\r
+# |- Include        : Include files for Nt32Pkg\r
+# \r
 #\r
 # Copyright (c) 2007, Intel Corporation. <BR>\r
 #\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
+# 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
+# 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
 #\r
-#**/\r
-\r
-\r
-################################################################################\r
 #\r
-# Defines Section - statements that will be processed to create a Makefile.\r
+\r
+## Basic definitions for Nt32 package.\r
 #\r
-################################################################################\r
 \r
 [Defines]\r
-\r
   DEC_SPECIFICATION              = 0x00010005\r
   PACKAGE_NAME                   = Nt32Pkg\r
   PACKAGE_GUID                   = 0fb2aa2d-10d5-40a5-a9dc-060c12a4a3f3\r
   PACKAGE_VERSION                = 0.1\r
 \r
-################################################################################\r
-#\r
-# Include Section - list of Include Paths that are provided by this package.\r
-#                   Comments are used for Keywords and Module Types.\r
+##\r
+# Include Paths that are provided by this package.\r
 #\r
-# Supported Module Types:\r
-#  SEC PEI_CORE PEIM DXE_CORE DXE_DRIVER DXE_RUNTIME_DRIVER DXE_SMM_DRIVER DXE_SAL_DRIVER UEFI_DRIVER\r
-#\r
-################################################################################\r
 [Includes.common]\r
   Include                        # Root include for the package\r
 \r
-\r
-################################################################################\r
+##\r
+# LibraryClasses provided by Nt32Pkg for all architecture. \r
 #\r
-# Library Class Header section - list of Library Class header files that are\r
-#                                provided by this package.\r
-#\r
-################################################################################\r
 [LibraryClasses.common]\r
+  ##\r
+  #  Expose EFI_WIN_NT_THUNK_PROTOCOL's interface, this protocol wrapper all \r
+  #  necessary Window API used by Nt32 enumlation environment.\r
   WinNtLib|Include/Library/WinNtLib.h\r
 \r
-################################################################################\r
-#\r
-# Global Guid Definition section - list of Global Guid C Name Data Structures\r
-#                                  that are provided by this package.\r
+##\r
+# Guids provided by Nt32Pkg for all architecture.\r
 #\r
-################################################################################\r
 [Guids.common]\r
   gEfiWinNtPassThroughGuid       = { 0xCC664EB8, 0x3C24, 0x4086, { 0xB6, 0xF6, 0x34, 0xE8, 0x56, 0xBC, 0xE3, 0x6E }}\r
   gEfiWinNtConsoleGuid           = { 0xBA73672C, 0xA5D3, 0x11D4, { 0xBD, 0x00, 0x00, 0x80, 0xC7, 0x3C, 0x88, 0x81 }}\r
   gEfiNt32PkgTokenSpaceGuid      = { 0x0D79A645, 0x1D91, 0x40a6, { 0xA8, 0x1F, 0x61, 0xE6, 0x98, 0x2B, 0x32, 0xB4 }}\r
   \r
 \r
-################################################################################\r
+##\r
+# Protocols provided by Nt32Pkg for all architecture.\r
 #\r
-# Global Protocols Definition section - list of Global Protocols C Name Data\r
-#                                  Structures that are provided by this package.\r
-#\r
-################################################################################\r
 [Protocols.common]\r
   gWinNtBusDriverGuid            = { 0x0419f582, 0x0625, 0x4531, { 0x8a, 0x33, 0x85, 0xa9, 0x96, 0x5c, 0x95, 0xbc }}\r
   gEfiWinNtThunkProtocolGuid     = { 0x58C518B1, 0x76F3, 0x11D4, { 0xBC, 0xEA, 0x00, 0x80, 0xC7, 0x3C, 0x88, 0x81 }}\r
   gEfiWinNtIoProtocolGuid        = { 0x96EB4AD6, 0xA32A, 0x11D4, { 0xBC, 0xFD, 0x00, 0x80, 0xC7, 0x3C, 0x88, 0x81 }}\r
 \r
-################################################################################\r
-#\r
-# Global Ppis Definition section - list of Global Ppis C Name Data Structures\r
-#                                  that are provided by this package.\r
+##\r
+# Ppis provide by Nt32Pkg for all architecture\r
 #\r
-################################################################################\r
 [Ppis.common]\r
+  ## This PPI wrapper all necessary windows API used by PEI driver in NT32 environment.\r
   gPeiNtThunkPpiGuid             = { 0x98c281e5, 0xf906, 0x43dd, { 0xa9, 0x2b, 0xb0, 0x03, 0xbf, 0x27, 0x65, 0xda }}\r
+  ## This PPI provide system memory scan interface which simulate real platform perform\r
+  # memory's auto scan.\r
   gPeiNtAutoScanPpiGuid          = { 0x0dce384d, 0x007c, 0x4ba5, { 0x94, 0xbd, 0x0f, 0x6e, 0xb6, 0x4d, 0x2a, 0xa9 }}\r
+  ## This PPI provide interace to loads and relocates a PE/COFF image into memory.\r
   gNtPeiLoadFilePpiGuid          = { 0xfd0c65eb, 0x0405, 0x4cd2, { 0x8a, 0xee, 0xf4, 0x0, 0xef, 0x13, 0xba, 0xc2 }}\r
+  ## This PPI instance hold information for an simulated firmware device.\r
   gNtFwhPpiGuid                  = { 0x4e76928f, 0x50ad, 0x4334, {0xb0, 0x6b, 0xa8, 0x42, 0x13, 0x10, 0x8a, 0x57 }}\r
   \r
-################################################################################\r
+## This section list all "Fixed At Build" type PCD produced by NT32 package.\r
 #\r
-# PCD Declarations section - list of all PCDs Declared by this Package\r
-#                            Only this package should be providing the\r
-#                            declaration, other packages should not.\r
+# "Fixed At Build" type PCD can be seems as constant and its value will not be \r
+# changed after customized in DSC file.\r
 #\r
-################################################################################\r
-\r
 [PcdsFixedAtBuild.common]\r
   gEfiNt32PkgTokenSpaceGuid.PcdWinNtBootMode|1|UINT32|0x00001006\r
   gEfiNt32PkgTokenSpaceGuid.PcdWinNtFirmwareVolume|L"..\\Fv\\Fv_Recovery.fd"|VOID*|0x00001009\r
   gEfiNt32PkgTokenSpaceGuid.PcdWinNtFlashNvStorageFtwWorkingBase|0x0|UINT32|0x00001016\r
   gEfiNt32PkgTokenSpaceGuid.PcdWinNtFdBaseAddress|0x0|UINT32|0x00001017\r
 \r
+## This section list all "Dynamic" type PCD produced by NT32 package.\r
+# \r
+# "Dynamic" type PCD will be managed by PCD database driver at execution time.\r
+# its value can be modified by PCD_PPI/PCD_PROTOCOL at execution time.\r
+#\r
 [PcdsDynamic.common]\r
   gEfiNt32PkgTokenSpaceGuid.PcdWinNtPhysicalDisk|L"E:RW;245760;512"|VOID*|0x00001000\r
   gEfiNt32PkgTokenSpaceGuid.PcdWinNtVirtualDisk|L"FW;40960;512"|VOID*|0x00001001\r
   gEfiNt32PkgTokenSpaceGuid.PcdWinNtConsole|L"Bus Driver Console Window"|VOID*|0x0000100a\r
   gEfiNt32PkgTokenSpaceGuid.PcdWinNtGop|L"UGA Window 1!UGA Window 2"|VOID*|0x0000100d\r
 \r
+## This section list all "PatchableInModule" type PCD produced by NT32 package.\r
+# "PatchableInModule" type PCD can be seems as global variable and its value is \r
+# stored in PE file data section of module. This type PCD mainly is designed for \r
+# binary module. \r
+#\r
 [PcdsPatchableInModule.common]\r
   gEfiNt32PkgTokenSpaceGuid.PcdWinNtBootMode|1|UINT32|0x00001006\r
   gEfiNt32PkgTokenSpaceGuid.PcdWinNtFirmwareVolume|L"..\\Fv\\Fv_Recovery.fd"|VOID*|0x00001009\r