tyler.durden
/
audk
mirror of https://github.com/acidanthera/audk.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Second set of changes based on a review of the code comments in the Include directory for typos, grammar issues, and language clarity. 

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8467 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
pkandel 2009-06-04 16:16:15 +00:00
parent 7076244ef4
commit 1a2f870c9b
38 changed files with 268 additions and 307 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
MdePkg/Include/Base.h
View File

@ -333,18 +333,9 @@ struct _LIST_ENTRY {
// } // }
// //
/**
Return the size of argument that has been aligned to sizeof (UINTN).
@param n The parameter size is to be aligned.
@return The aligned size
**/
#define _INT_SIZE_OF(n) ((sizeof (n) + sizeof (UINTN) - 1) &~(sizeof (UINTN) - 1))
#if defined(__GNUC__) #if defined(__GNUC__)
// //
// Use GCC builtin macros for variable argument lists. // Use GCC built-in macros for variable argument lists.
// //
typedef __builtin_va_list VA_LIST; typedef __builtin_va_list VA_LIST;
@ -355,6 +346,15 @@ typedef __builtin_va_list VA_LIST;
#define VA_END(Marker) __builtin_va_end (Marker) #define VA_END(Marker) __builtin_va_end (Marker)
#else #else
/**
Return the size of argument that has been aligned to sizeof (UINTN).
@param n The parameter size to be aligned.
@return The aligned size
**/
#define _INT_SIZE_OF(n) ((sizeof (n) + sizeof (UINTN) - 1) &~(sizeof (UINTN) - 1))
/// ///
/// Pointer to the start of a variable argument list. Same as CHAR8 *. /// Pointer to the start of a variable argument list. Same as CHAR8 *.
/// ///
@ -409,29 +409,6 @@ typedef CHAR8 *VA_LIST;
#endif #endif
///
/// Pointer to the start of a variable argument list stored in a memory buffer. Same as UINT8 *.
///
typedef UINTN *BASE_LIST;
/**
Returns an argument of a specified type from a variable argument list and updates
the pointer to the variable argument list to point to the next argument.
This function returns an argument of the type specified by TYPE from the beginning
of the variable argument list specified by Marker. Marker is then updated to point
to the next argument in the variable argument list. The method for computing the
pointer to the next argument in the argument list is CPU specific following the EFIAPI ABI.
@param Marker Pointer to the beginning of a variable argument list.
@param TYPE The type of argument to retrieve from the beginning
of the variable argument list.
@return An argument of the type specified by TYPE.
**/
#define BASE_ARG(Marker, TYPE) (*(TYPE *)((UINT8 *)(Marker = (BASE_LIST)((UINT8 *)Marker + _INT_SIZE_OF (TYPE))) - _INT_SIZE_OF (TYPE)))
/** /**
Macro that returns the byte offset of a field in a data structure. Macro that returns the byte offset of a field in a data structure.
@ -455,7 +432,7 @@ typedef UINTN *BASE_LIST;
This function computes the offset, in bytes, of field specified by Field from the beginning This function computes the offset, in bytes, of field specified by Field from the beginning
of the data structure specified by TYPE. This offset is subtracted from Record, and is of the data structure specified by TYPE. This offset is subtracted from Record, and is
used to return a pointer to a data structure of the type specified by TYPE.If the data type used to return a pointer to a data structure of the type specified by TYPE. If the data type
specified by TYPE does not contain the field specified by Field, then the module will not compile. specified by TYPE does not contain the field specified by Field, then the module will not compile.
@param Record Pointer to the field specified by Field within a data structure of type TYPE. @param Record Pointer to the field specified by Field within a data structure of type TYPE.

2
MdePkg/Include/Ebc/ProcessorBind.h
View File

@ -1,7 +1,7 @@
/** @file /** @file
Processor or compiler specific defines and types for EBC. Processor or compiler specific defines and types for EBC.
We currently only have one EBC complier so there may be some Intel compiler We currently only have one EBC compiler so there may be some Intel compiler
specific functions in this file. specific functions in this file.
Copyright (c) 2006 - 2009, Intel Corporation<BR> Copyright (c) 2006 - 2009, Intel Corporation<BR>

2
MdePkg/Include/Guid/Apriori.h
View File

@ -1,7 +1,7 @@
/** @file /** @file
GUID used as an FV filename for A Priori file. The A Priori file contains a GUID used as an FV filename for A Priori file. The A Priori file contains a
list of FV filenames that the DXE dispatcher will schedule reguardless of list of FV filenames that the DXE dispatcher will schedule reguardless of
the dependency grammer. the dependency grammar.
Copyright (c) 2006 - 2008, Intel Corporation Copyright (c) 2006 - 2008, Intel Corporation
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials

2
MdePkg/Include/Guid/FileInfo.h
View File

@ -1,7 +1,7 @@
/** @file /** @file
Provides a GUID and a data structure that can be used with EFI_FILE_PROTOCOL.SetInfo() Provides a GUID and a data structure that can be used with EFI_FILE_PROTOCOL.SetInfo()
and EFI_FILE_PROTOCOL.GetInfo() to set or get generic file information. and EFI_FILE_PROTOCOL.GetInfo() to set or get generic file information.
This guid is defined in UEFI specification. This GUID is defined in UEFI specification.
Copyright (c) 2006 - 2008, Intel Corporation Copyright (c) 2006 - 2008, Intel Corporation
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials

2
MdePkg/Include/Guid/FileSystemInfo.h
View File

@ -1,7 +1,7 @@
/** @file /** @file
Provides a GUID and a data structure that can be used with EFI_FILE_PROTOCOL.GetInfo() Provides a GUID and a data structure that can be used with EFI_FILE_PROTOCOL.GetInfo()
or EFI_FILE_PROTOCOL.SetInfo() to get or set information about the system's volume. or EFI_FILE_PROTOCOL.SetInfo() to get or set information about the system's volume.
This guid is defined in UEFI specification. This GUID is defined in UEFI specification.
Copyright (c) 2006 - 2008, Intel Corporation Copyright (c) 2006 - 2008, Intel Corporation
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials

2
MdePkg/Include/Guid/FileSystemVolumeLabelInfo.h
View File

@ -1,7 +1,7 @@
/** @file /** @file
Provides a GUID and a data structure that can be used with EFI_FILE_PROTOCOL.GetInfo() Provides a GUID and a data structure that can be used with EFI_FILE_PROTOCOL.GetInfo()
or EFI_FILE_PROTOCOL.SetInfo() to get or set the system's volume label. or EFI_FILE_PROTOCOL.SetInfo() to get or set the system's volume label.
This guid is defined in UEFI specification. This GUID is defined in UEFI specification.
Copyright (c) 2006 - 2008, Intel Corporation Copyright (c) 2006 - 2008, Intel Corporation
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials

2
MdePkg/Include/Guid/Mps.h
View File

@ -1,6 +1,6 @@
/** @file /** @file
GUIDs used for MPS entries in the UEFI 2.0 system table GUIDs used for MPS entries in the UEFI 2.0 system table
ACPI is the primary means of exporting MP information to the OS. MPS obly was ACPI is the primary means of exporting MPS information to the OS. MPS only was
included to support Itanium-based platform power on. So don't use it if you don't have too. included to support Itanium-based platform power on. So don't use it if you don't have too.
Copyright (c) 2006, Intel Corporation Copyright (c) 2006, Intel Corporation

11
MdePkg/Include/Ia32/ProcessorBind.h
View File

@ -1,5 +1,5 @@
/** @file /** @file
Processor or Compiler specific defines and types for Ia32 architecture. Processor or Compiler specific defines and types for IA-32 architecture.
Copyright (c) 2006 - 2009, Intel Corporation<BR> Copyright (c) 2006 - 2009, Intel Corporation<BR>
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
@ -333,7 +333,7 @@ typedef INT32 INTN;
#endif #endif
// //
// Macros for GNU assembly code // For symbol name in GNU assembly code, an extra "_" is necessary
// //
#if defined(__GNUC__) #if defined(__GNUC__)
#if defined(linux) #if defined(linux)
@ -341,16 +341,11 @@ typedef INT32 INTN;
#else #else
#define ASM_PFX(name) _##name #define ASM_PFX(name) _##name
#endif #endif
///
/// For GNU assembly code, .global or .globl can declare global symbols.
/// Define this macro to unify the usage.
///
#define ASM_GLOBAL .globl
#endif #endif
/** /**
Return the pointer to the first instruction of a function given a function pointer. Return the pointer to the first instruction of a function given a function pointer.
On IA32 CPU architectures, these two pointer values are the same, On IA-32 CPU architectures, these two pointer values are the same,
so the implementation of this macro is very simple. so the implementation of this macro is very simple.
@param FunctionPointer A pointer to a function. @param FunctionPointer A pointer to a function.

110
MdePkg/Include/IndustryStandard/Pal.h
View File

@ -37,7 +37,7 @@
/** /**
PAL Procedure - PAL_CACHE_FLUSH. PAL Procedure - PAL_CACHE_FLUSH.
Flush the instruction or data caches. It is required by IPF. Flush the instruction or data caches. It is required by Itanium processors.
The PAL procedure supports the Static Registers calling The PAL procedure supports the Static Registers calling
convention. It could be called at virtual mode and physical convention. It could be called at virtual mode and physical
mode. mode.
@ -127,7 +127,7 @@ typedef struct {
PAL Procedure - PAL_CACHE_INFO. PAL Procedure - PAL_CACHE_INFO.
Return detailed instruction or data cache information. It is Return detailed instruction or data cache information. It is
required by IPF. The PAL procedure supports the Static required by Itanium processors. The PAL procedure supports the Static
Registers calling convention. It could be called at virtual Registers calling convention. It could be called at virtual
mode and physical mode. mode and physical mode.
@ -184,7 +184,7 @@ typedef struct {
PAL Procedure - PAL_CACHE_INIT. PAL Procedure - PAL_CACHE_INIT.
Initialize the instruction or data caches. It is required by Initialize the instruction or data caches. It is required by
IPF. The PAL procedure supports the Static Registers calling Itanium processors. The PAL procedure supports the Static Registers calling
convention. It could be called at physical mode. convention. It could be called at physical mode.
@param Index Index of PAL_CACHE_INIT within the list of PAL @param Index Index of PAL_CACHE_INIT within the list of PAL
@ -252,7 +252,7 @@ typedef struct {
PAL Procedure - PAL_CACHE_PROT_INFO. PAL Procedure - PAL_CACHE_PROT_INFO.
Return instruction or data cache protection information. It is Return instruction or data cache protection information. It is
required by IPF. The PAL procedure supports the Static required by Itanium processors. The PAL procedure supports the Static
Registers calling convention. It could be called at physical Registers calling convention. It could be called at physical
mode and Virtual mode. mode and Virtual mode.
@ -359,7 +359,7 @@ typedef struct {
PAL Procedure - PAL_CACHE_SUMMARY. PAL Procedure - PAL_CACHE_SUMMARY.
Return a summary of the cache hierarchy. It is required by Return a summary of the cache hierarchy. It is required by
IPF. The PAL procedure supports the Static Registers calling Itanium processors. The PAL procedure supports the Static Registers calling
convention. It could be called at physical mode and Virtual convention. It could be called at physical mode and Virtual
mode. mode.
@ -404,7 +404,7 @@ typedef struct {
PAL Procedure - PAL_MEM_ATTRIB. PAL Procedure - PAL_MEM_ATTRIB.
Return a list of supported memory attributes.. It is required Return a list of supported memory attributes.. It is required
by IPF. The PAL procedure supports the Static Registers calling by Itanium processors. The PAL procedure supports the Static Registers calling
convention. It could be called at physical mode and Virtual convention. It could be called at physical mode and Virtual
mode. mode.
@ -428,7 +428,7 @@ typedef struct {
Used in architected sequence to transition pages from a Used in architected sequence to transition pages from a
cacheable, speculative attribute to an uncacheable attribute. cacheable, speculative attribute to an uncacheable attribute.
It is required by IPF. The PAL procedure supports the Static It is required by Itanium processors. The PAL procedure supports the Static
Registers calling convention. It could be called at physical Registers calling convention. It could be called at physical
mode and Virtual mode. mode and Virtual mode.
@ -452,7 +452,7 @@ typedef struct {
PAL Procedure - PAL_PTCE_INFO. PAL Procedure - PAL_PTCE_INFO.
Return information needed for ptc.e instruction to purge Return information needed for ptc.e instruction to purge
entire TC. It is required by IPF. The PAL procedure supports entire TC. It is required by Itanium processors. The PAL procedure supports
the Static Registers calling convention. It could be called at the Static Registers calling convention. It could be called at
physical mode and Virtual mode. physical mode and Virtual mode.
@ -507,7 +507,7 @@ typedef struct {
PAL Procedure - PAL_VM_INFO. PAL Procedure - PAL_VM_INFO.
Return detailed information about virtual memory features Return detailed information about virtual memory features
supported in the processor. It is required by IPF. The PAL supported in the processor. It is required by Itanium processors. The PAL
procedure supports the Static Registers calling convention. It procedure supports the Static Registers calling convention. It
could be called at physical mode and Virtual mode. could be called at physical mode and Virtual mode.
@ -542,7 +542,7 @@ typedef struct {
PAL Procedure - PAL_VM_PAGE_SIZE. PAL Procedure - PAL_VM_PAGE_SIZE.
Return virtual memory TC and hardware walker page sizes Return virtual memory TC and hardware walker page sizes
supported in the processor. It is required by IPF. The PAL supported in the processor. It is required by Itanium processors. The PAL
procedure supports the Static Registers calling convention. It procedure supports the Static Registers calling convention. It
could be called at physical mode and Virtual mode. could be called at physical mode and Virtual mode.
@ -613,7 +613,7 @@ typedef struct {
PAL Procedure - PAL_VM_SUMMARY. PAL Procedure - PAL_VM_SUMMARY.
Return summary information about virtual memory features Return summary information about virtual memory features
supported in the processor. It is required by IPF. The PAL supported in the processor. It is required by Itanium processors. The PAL
procedure supports the Static Registers calling convention. It procedure supports the Static Registers calling convention. It
could be called at physical mode and Virtual mode. could be called at physical mode and Virtual mode.
@ -646,7 +646,7 @@ typedef struct {
PAL Procedure - PAL_VM_TR_READ. PAL Procedure - PAL_VM_TR_READ.
Read contents of a translation register. It is required by Read contents of a translation register. It is required by
IPF. The PAL procedure supports the Stacked Register calling Itanium processors. The PAL procedure supports the Stacked Register calling
convention. It could be called at physical mode. convention. It could be called at physical mode.
@param Index Index of PAL_VM_TR_READ within the list @param Index Index of PAL_VM_TR_READ within the list
@ -838,7 +838,7 @@ typedef struct {
PAL Procedure - PAL_BUS_GET_FEATURES. PAL Procedure - PAL_BUS_GET_FEATURES.
Return configurable processor bus interface features and their Return configurable processor bus interface features and their
current settings. It is required by IPF. The PAL procedure current settings. It is required by Itanium processors. The PAL procedure
supports the Stacked Register calling convention. It could be supports the Stacked Register calling convention. It could be
called at physical mode. called at physical mode.
@ -862,7 +862,7 @@ typedef struct {
PAL Procedure - PAL_BUS_SET_FEATURES. PAL Procedure - PAL_BUS_SET_FEATURES.
Enable or disable configurable features in processor bus Enable or disable configurable features in processor bus
interface. It is required by IPF. It is required by IPF. The PAL procedure interface. It is required by Itanium processors. The PAL procedure
supports the Static Registers calling convention. It could be supports the Static Registers calling convention. It could be
called at physical mode. called at physical mode.
@ -883,7 +883,7 @@ typedef struct {
PAL Procedure - PAL_DEBUG_INFO. PAL Procedure - PAL_DEBUG_INFO.
Return the number of instruction and data breakpoint Return the number of instruction and data breakpoint
registers. It is required by IPF. It is required by IPF. The registers. It is required by Itanium processors. The
PAL procedure supports the Static Registers calling PAL procedure supports the Static Registers calling
convention. It could be called at physical mode and virtual convention. It could be called at physical mode and virtual
mode. mode.
@ -909,7 +909,7 @@ typedef struct {
PAL Procedure - PAL_FIXED_ADDR. PAL Procedure - PAL_FIXED_ADDR.
Return the fixed component of a processor's directed address. Return the fixed component of a processor's directed address.
It is required by IPF. It is required by IPF. The PAL It is required by Itanium processors. The PAL
procedure supports the Static Registers calling convention. It procedure supports the Static Registers calling convention. It
could be called at physical mode and virtual mode. could be called at physical mode and virtual mode.
@ -954,7 +954,7 @@ typedef struct {
Return ratio of processor, bus, and interval time counter to Return ratio of processor, bus, and interval time counter to
processor input clock or output clock for platform use, if processor input clock or output clock for platform use, if
generated by the processor. It is required by IPF. The PAL generated by the processor. It is required by Itanium processors. The PAL
procedure supports the Static Registers calling convention. It procedure supports the Static Registers calling convention. It
could be called at physical mode and virtual mode. could be called at physical mode and virtual mode.
@ -1081,7 +1081,7 @@ typedef struct {
PAL Procedure - PAL_PERF_MON_INFO. PAL Procedure - PAL_PERF_MON_INFO.
Return the number and type of performance monitors. It is Return the number and type of performance monitors. It is
required by IPF. The PAL procedure supports the Static required by Itanium processors. The PAL procedure supports the Static
Registers calling convention. It could be called at physical Registers calling convention. It could be called at physical
mode and virtual mode. mode and virtual mode.
@ -1107,7 +1107,7 @@ typedef struct {
PAL Procedure - PAL_PLATFORM_ADDR. PAL Procedure - PAL_PLATFORM_ADDR.
Specify processor interrupt block address and I/O port space Specify processor interrupt block address and I/O port space
address. It is required by IPF. The PAL procedure supports the address. It is required by Itanium processors. The PAL procedure supports the
Static Registers calling convention. It could be called at Static Registers calling convention. It could be called at
physical mode and virtual mode. physical mode and virtual mode.
@ -1448,7 +1448,7 @@ typedef struct {
PAL Procedure - PAL_PROC_GET_FEATURES. PAL Procedure - PAL_PROC_GET_FEATURES.
Return configurable processor features and their current Return configurable processor features and their current
setting. It is required by IPF. The PAL procedure supports the setting. It is required by Itanium processors. The PAL procedure supports the
Static Registers calling convention. It could be called at Static Registers calling convention. It could be called at
physical mode and virtual mode. physical mode and virtual mode.
@ -1482,7 +1482,7 @@ typedef struct {
PAL Procedure - PAL_PROC_SET_FEATURES. PAL Procedure - PAL_PROC_SET_FEATURES.
Enable or disable configurable processor features. It is Enable or disable configurable processor features. It is
required by IPF. The PAL procedure supports the Static required by Itanium processors. The PAL procedure supports the Static
Registers calling convention. It could be called at physical Registers calling convention. It could be called at physical
mode. mode.
@ -1519,7 +1519,7 @@ typedef struct {
/** /**
PAL Procedure - PAL_REGISTER_INFO. PAL Procedure - PAL_REGISTER_INFO.
Return AR and CR register information. It is required by IPF. Return AR and CR register information. It is required by Itanium processors.
The PAL procedure supports the Static Registers calling The PAL procedure supports the Static Registers calling
convention. It could be called at physical mode and virtual convention. It could be called at physical mode and virtual
mode. mode.
@ -1546,7 +1546,7 @@ typedef struct {
/** /**
PAL Procedure - PAL_RSE_INFO. PAL Procedure - PAL_RSE_INFO.
Return RSE information. It is required by IPF. The PAL Return RSE information. It is required by Itanium processors. The PAL
procedure supports the Static Registers calling convention. It procedure supports the Static Registers calling convention. It
could be called at physical mode and virtual mode. could be called at physical mode and virtual mode.
@ -1587,7 +1587,7 @@ typedef struct {
/** /**
PAL Procedure - PAL_VERSION. PAL Procedure - PAL_VERSION.
Return version of PAL code. It is required by IPF. The PAL Return version of PAL code. It is required by Itanium processors. The PAL
procedure supports the Static Registers calling convention. It procedure supports the Static Registers calling convention. It
could be called at physical mode and virtual mode. could be called at physical mode and virtual mode.
@ -1623,7 +1623,7 @@ typedef struct {
PAL Procedure - PAL_MC_CLEAR_LOG. PAL Procedure - PAL_MC_CLEAR_LOG.
Clear all error information from processor error logging Clear all error information from processor error logging
registers. It is required by IPF. The PAL procedure supports registers. It is required by Itanium processors. The PAL procedure supports
the Static Registers calling convention. It could be called at the Static Registers calling convention. It could be called at
physical mode and virtual mode. physical mode and virtual mode.
@ -1644,7 +1644,7 @@ typedef struct {
PAL Procedure - PAL_MC_DRAIN. PAL Procedure - PAL_MC_DRAIN.
Ensure that all operations that could cause an MCA have Ensure that all operations that could cause an MCA have
completed. It is required by IPF. The PAL procedure supports completed. It is required by Itanium processors. The PAL procedure supports
the Static Registers calling convention. It could be called at the Static Registers calling convention. It could be called at
physical mode and virtual mode. physical mode and virtual mode.
@ -1916,7 +1916,7 @@ typedef struct {
PAL Procedure - PAL_MC_ERROR_INFO. PAL Procedure - PAL_MC_ERROR_INFO.
Return Processor Machine Check Information and Processor Return Processor Machine Check Information and Processor
Static State for logging by SAL. It is required by IPF. The Static State for logging by SAL. It is required by Itanium processors. The
PAL procedure supports the Static Registers calling PAL procedure supports the Static Registers calling
convention. It could be called at physical and virtual mode. convention. It could be called at physical and virtual mode.
@ -1955,7 +1955,7 @@ typedef struct {
PAL Procedure - PAL_MC_EXPECTED. PAL Procedure - PAL_MC_EXPECTED.
Set/Reset Expected Machine Check Indicator. It is required by Set/Reset Expected Machine Check Indicator. It is required by
IPF. The PAL procedure supports the Static Registers calling Itanium processors. The PAL procedure supports the Static Registers calling
convention. It could be called at physical mode. convention. It could be called at physical mode.
@param Index Index of PAL_MC_EXPECTED within the list of PAL @param Index Index of PAL_MC_EXPECTED within the list of PAL
@ -1979,7 +1979,7 @@ typedef struct {
PAL Procedure - PAL_MC_REGISTER_MEM. PAL Procedure - PAL_MC_REGISTER_MEM.
Register min-state save area with PAL for machine checks and Register min-state save area with PAL for machine checks and
inits. It is required by IPF. The PAL procedure supports the inits. It is required by Itanium processors. The PAL procedure supports the
Static Registers calling convention. It could be called at Static Registers calling convention. It could be called at
physical mode. physical mode.
@ -1999,7 +1999,7 @@ typedef struct {
PAL Procedure - PAL_MC_RESUME. PAL Procedure - PAL_MC_RESUME.
Restore minimal architected state and return to interrupted Restore minimal architected state and return to interrupted
process. It is required by IPF. The PAL procedure supports the process. It is required by Itanium processors. The PAL procedure supports the
Static Registers calling convention. It could be called at Static Registers calling convention. It could be called at
physical mode. physical mode.
@ -2057,7 +2057,7 @@ typedef struct {
PAL Procedure - PAL_HALT_INFO. PAL Procedure - PAL_HALT_INFO.
Return the low power capabilities of the processor. It is Return the low power capabilities of the processor. It is
required by IPF. The PAL procedure supports the required by Itanium processors. The PAL procedure supports the
Stacked Registers calling convention. It could be called at Stacked Registers calling convention. It could be called at
physical and virtual mode. physical and virtual mode.
@ -2078,7 +2078,7 @@ typedef struct {
PAL Procedure - PAL_HALT_LIGHT. PAL Procedure - PAL_HALT_LIGHT.
Enter the low power LIGHT HALT state. It is required by Enter the low power LIGHT HALT state. It is required by
IPF. The PAL procedure supports the Static Registers calling Itanium processors. The PAL procedure supports the Static Registers calling
convention. It could be called at physical and virtual mode. convention. It could be called at physical and virtual mode.
@param Index Index of PAL_HALT_LIGHT within the list of PAL @param Index Index of PAL_HALT_LIGHT within the list of PAL
@ -2095,7 +2095,7 @@ typedef struct {
PAL Procedure - PAL_CACHE_LINE_INIT. PAL Procedure - PAL_CACHE_LINE_INIT.
Initialize tags and data of a cache line for processor Initialize tags and data of a cache line for processor
testing. It is required by IPF. The PAL procedure supports the testing. It is required by Itanium processors. The PAL procedure supports the
Static Registers calling convention. It could be called at Static Registers calling convention. It could be called at
physical and virtual mode. physical and virtual mode.
@ -2185,7 +2185,7 @@ typedef struct {
Returns alignment and size requirements needed for the memory Returns alignment and size requirements needed for the memory
buffer passed to the PAL_TEST_PROC procedure as well as buffer passed to the PAL_TEST_PROC procedure as well as
information on self-test control words for the processor self information on self-test control words for the processor self
tests. It is required by IPF. The PAL procedure supports the tests. It is required by Itanium processors. The PAL procedure supports the
Static Registers calling convention. It could be called at Static Registers calling convention. It could be called at
physical mode. physical mode.
@ -2347,7 +2347,7 @@ typedef struct {
/** /**
PAL Procedure - PAL_TEST_PROC. PAL Procedure - PAL_TEST_PROC.
Perform late processor self test. It is required by IPF. The Perform late processor self test. It is required by Itanium processors. The
PAL procedure supports the Static Registers calling PAL procedure supports the Static Registers calling
convention. It could be called at physical mode. convention. It could be called at physical mode.
@ -2391,7 +2391,7 @@ typedef struct {
PAL Procedure - PAL_COPY_INFO. PAL Procedure - PAL_COPY_INFO.
Return information needed to relocate PAL procedures and PAL Return information needed to relocate PAL procedures and PAL
PMI code to memory. It is required by IPF. The PAL procedure PMI code to memory. It is required by Itanium processors. The PAL procedure
supports the Static Registers calling convention. It could be supports the Static Registers calling convention. It could be
called at physical mode. called at physical mode.
@ -2425,7 +2425,7 @@ typedef struct {
PAL Procedure - PAL_COPY_PAL. PAL Procedure - PAL_COPY_PAL.
Relocate PAL procedures and PAL PMI code to memory. It is Relocate PAL procedures and PAL PMI code to memory. It is
required by IPF. The PAL procedure supports the Stacked required by Itanium processors. The PAL procedure supports the Stacked
Registers calling convention. It could be called at physical Registers calling convention. It could be called at physical
mode. mode.
@ -2524,7 +2524,7 @@ typedef struct {
PAL Procedure - PAL_PMI_ENTRYPOINT. PAL Procedure - PAL_PMI_ENTRYPOINT.
Register PMI memory entrypoints with processor. It is required Register PMI memory entrypoints with processor. It is required
by IPF. The PAL procedure supports the Stacked Registers by Itanium processors. The PAL procedure supports the Stacked Registers
calling convention. It could be called at physical mode. calling convention. It could be called at physical mode.
@param Index Index of PAL_PMI_ENTRYPOINT within the list of @param Index Index of PAL_PMI_ENTRYPOINT within the list of
@ -2558,7 +2558,7 @@ typedef struct {
PAL Procedure - PAL_BRAND_INFO. PAL Procedure - PAL_BRAND_INFO.
Provides processor branding information. It is optional by Provides processor branding information. It is optional by
IPF. The PAL procedure supports the Stacked Registers calling Itanium processors. The PAL procedure supports the Stacked Registers calling
convention. It could be called at physical and Virtual mode. convention. It could be called at physical and Virtual mode.
@param Index Index of PAL_BRAND_INFO within the list of PAL @param Index Index of PAL_BRAND_INFO within the list of PAL
@ -2586,7 +2586,7 @@ typedef struct {
PAL Procedure - PAL_GET_HW_POLICY. PAL Procedure - PAL_GET_HW_POLICY.
Returns the current hardware resource sharing policy of the Returns the current hardware resource sharing policy of the
processor. It is optional by IPF. The PAL procedure supports processor. It is optional by Itanium processors. The PAL procedure supports
the Static Registers calling convention. It could be called at the Static Registers calling convention. It could be called at
physical and Virtual mode. physical and Virtual mode.
@ -2635,7 +2635,7 @@ typedef struct {
PAL Procedure - PAL_SET_HW_POLICY. PAL Procedure - PAL_SET_HW_POLICY.
Sets the current hardware resource sharing policy of the Sets the current hardware resource sharing policy of the
processor. It is optional by IPF. The PAL procedure supports processor. It is optional by Itanium processors. The PAL procedure supports
the Static Registers calling convention. It could be called at the Static Registers calling convention. It could be called at
physical and Virtual mode. physical and Virtual mode.
@ -2825,7 +2825,7 @@ typedef struct {
Injects the requested processor error or returns information Injects the requested processor error or returns information
on the supported injection capabilities for this particular on the supported injection capabilities for this particular
processor implementation. It is optional by IPF. The PAL processor implementation. It is optional by Itanium processors. The PAL
procedure supports the Stacked Registers calling convention. procedure supports the Stacked Registers calling convention.
It could be called at physical and Virtual mode. It could be called at physical and Virtual mode.
@ -2880,7 +2880,7 @@ typedef struct {
PAL Procedure - PAL_GET_PSTATE. PAL Procedure - PAL_GET_PSTATE.
Returns the performance index of the processor. It is optional Returns the performance index of the processor. It is optional
by IPF. The PAL procedure supports the Stacked Registers by Itanium processors. The PAL procedure supports the Stacked Registers
calling convention. It could be called at physical and Virtual calling convention. It could be called at physical and Virtual
mode. mode.
@ -2928,7 +2928,7 @@ typedef struct {
PAL Procedure - PAL_PSTATE_INFO. PAL Procedure - PAL_PSTATE_INFO.
Returns information about the P-states supported by the Returns information about the P-states supported by the
processor. It is optional by IPF. The PAL procedure supports processor. It is optional by Itanium processors. The PAL procedure supports
the Static Registers calling convention. It could be called the Static Registers calling convention. It could be called
at physical and Virtual mode. at physical and Virtual mode.
@ -2955,7 +2955,7 @@ typedef struct {
PAL Procedure - PAL_SET_PSTATE. PAL Procedure - PAL_SET_PSTATE.
To request a processor transition to a given P-state. It is To request a processor transition to a given P-state. It is
optional by IPF. The PAL procedure supports the Stacked optional by Itanium processors. The PAL procedure supports the Stacked
Registers calling convention. It could be called at physical Registers calling convention. It could be called at physical
and Virtual mode. and Virtual mode.
@ -2982,7 +2982,7 @@ typedef struct {
PAL Procedure - PAL_SHUTDOWN. PAL Procedure - PAL_SHUTDOWN.
Put the logical processor into a low power state which can be Put the logical processor into a low power state which can be
exited only by a reset event. It is optional by IPF. The PAL exited only by a reset event. It is optional by Itanium processors. The PAL
procedure supports the Static Registers calling convention. It procedure supports the Static Registers calling convention. It
could be called at physical mode. could be called at physical mode.
@ -3017,7 +3017,7 @@ typedef struct {
PAL Procedure - PAL_MEMORY_BUFFER. PAL Procedure - PAL_MEMORY_BUFFER.
Provides cacheable memory to PAL for exclusive use during Provides cacheable memory to PAL for exclusive use during
runtime. It is optional by IPF. The PAL procedure supports the runtime. It is optional by Itanium processors. The PAL procedure supports the
Static Registers calling convention. It could be called at Static Registers calling convention. It could be called at
physical mode. physical mode.
@ -3051,7 +3051,7 @@ typedef struct {
PAL Procedure - PAL_VP_CREATE. PAL Procedure - PAL_VP_CREATE.
Initializes a new vpd for the operation of a new virtual Initializes a new vpd for the operation of a new virtual
processor in the virtual environment. It is optional by IPF. processor in the virtual environment. It is optional by Itanium processors.
The PAL procedure supports the Stacked Registers calling The PAL procedure supports the Stacked Registers calling
convention. It could be called at Virtual mode. convention. It could be called at Virtual mode.
@ -3089,7 +3089,7 @@ typedef struct {
PAL Procedure - PAL_VP_ENV_INFO. PAL Procedure - PAL_VP_ENV_INFO.
Returns the parameters needed to enter a virtual environment. Returns the parameters needed to enter a virtual environment.
It is optional by IPF. The PAL procedure supports the Stacked It is optional by Itanium processors. The PAL procedure supports the Stacked
Registers calling convention. It could be called at Virtual Registers calling convention. It could be called at Virtual
mode. mode.
@ -3123,7 +3123,7 @@ typedef struct {
PAL Procedure - PAL_VP_EXIT_ENV. PAL Procedure - PAL_VP_EXIT_ENV.
Allows a logical processor to exit a virtual environment. Allows a logical processor to exit a virtual environment.
It is optional by IPF. The PAL procedure supports the Stacked It is optional by Itanium processors. The PAL procedure supports the Stacked
Registers calling convention. It could be called at Virtual Registers calling convention. It could be called at Virtual
mode. mode.
@ -3147,7 +3147,7 @@ typedef struct {
PAL Procedure - PAL_VP_INIT_ENV. PAL Procedure - PAL_VP_INIT_ENV.
Allows a logical processor to enter a virtual environment. It Allows a logical processor to enter a virtual environment. It
is optional by IPF. The PAL procedure supports the Stacked is optional by Itanium processors. The PAL procedure supports the Stacked
Registers calling convention. It could be called at Virtual Registers calling convention. It could be called at Virtual
mode. mode.
@ -3195,7 +3195,7 @@ typedef struct {
Register a different host IVT and/or a different optional Register a different host IVT and/or a different optional
virtualization intercept handler for the virtual processor virtualization intercept handler for the virtual processor
specified by vpd. It is optional by IPF. The PAL procedure specified by vpd. It is optional by Itanium processors. The PAL procedure
supports the Stacked Registers calling convention. It could be supports the Stacked Registers calling convention. It could be
called at Virtual mode. called at Virtual mode.
@ -3223,7 +3223,7 @@ typedef struct {
PAL Procedure - PAL_VP_RESTORE. PAL Procedure - PAL_VP_RESTORE.
Restores virtual processor state for the specified vpd on the Restores virtual processor state for the specified vpd on the
logical processor. It is optional by IPF. The PAL procedure logical processor. It is optional by Itanium processors. The PAL procedure
supports the Stacked Registers calling convention. It could be supports the Stacked Registers calling convention. It could be
called at Virtual mode. called at Virtual mode.
@ -3250,7 +3250,7 @@ typedef struct {
PAL Procedure - PAL_VP_SAVE. PAL Procedure - PAL_VP_SAVE.
Saves virtual processor state for the specified vpd on the Saves virtual processor state for the specified vpd on the
logical processor. It is optional by IPF. The PAL procedure logical processor. It is optional by Itanium processors. The PAL procedure
supports the Stacked Registers calling convention. It could be supports the Stacked Registers calling convention. It could be
called at Virtual mode. called at Virtual mode.
@ -3278,7 +3278,7 @@ typedef struct {
PAL Procedure - PAL_VP_TERMINATE. PAL Procedure - PAL_VP_TERMINATE.
Terminates operation for the specified virtual processor. It Terminates operation for the specified virtual processor. It
is optional by IPF. The PAL procedure supports the Stacked is optional by Itanium processors. The PAL procedure supports the Stacked
Registers calling convention. It could be called at Virtual Registers calling convention. It could be called at Virtual
mode. mode.

2
MdePkg/Include/IndustryStandard/Pci.h
View File

@ -1,5 +1,5 @@
/** @file /** @file
Support for The latest PCI standard. Support for the latest PCI standard.
Copyright (c) 2006 - 2008, Intel Corporation Copyright (c) 2006 - 2008, Intel Corporation
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials

2
MdePkg/Include/IndustryStandard/Tpm12.h
View File

@ -151,7 +151,7 @@ typedef UINT32 TPM_KEY_CONTROL;
/// ///
typedef UINT32 TPM_NV_INDEX; typedef UINT32 TPM_NV_INDEX;
/// ///
/// The family ID. Families ID's are automatically assigned a sequence number by the TPM. /// The family ID. Family IDs are automatically assigned a sequence number by the TPM.
/// A trusted process can set the FamilyID value in an individual row to NULL, which /// A trusted process can set the FamilyID value in an individual row to NULL, which
/// invalidates that row. The family ID resets to NULL on each change of TPM Owner. /// invalidates that row. The family ID resets to NULL on each change of TPM Owner.
/// ///

16
MdePkg/Include/Ipf/ProcessorBind.h
View File

@ -1,5 +1,5 @@
/** @file /** @file
Processor or Compiler specific defines and types for Intel Itanium(TM). Processor or Compiler specific defines and types for Intel Itanium(TM) processors.
Copyright (c) 2006 - 2009, Intel Corporation<BR> Copyright (c) 2006 - 2009, Intel Corporation<BR>
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
@ -17,7 +17,7 @@
/// ///
/// Define the processor type so other code can make processor based choices /// Define the processor type so other code can make processor-based choices
/// ///
#define MDE_CPU_IPF #define MDE_CPU_IPF
@ -84,7 +84,7 @@
// //
// Can not cast a function pointer to a data pointer. We need to do this on // Can not cast a function pointer to a data pointer. We need to do this on
// IPF to get access to the PLABEL. // Itanium processors to get access to the PLABEL.
// //
#pragma warning ( disable : 4514 ) #pragma warning ( disable : 4514 )
@ -108,7 +108,7 @@
#if defined(_MSC_EXTENSIONS) #if defined(_MSC_EXTENSIONS)
// //
// use Microsoft C complier dependent integer width types // use Microsoft C compiler dependent integer width types
// //
/// ///
@ -392,12 +392,6 @@ typedef INT64 INTN;
#define GLOBAL_REMOVE_IF_UNREFERENCED #define GLOBAL_REMOVE_IF_UNREFERENCED
#endif #endif
///
/// For GNU assembly code, .global or .globl can declare global symbols.
/// Define this macro to unify the usage.
///
#define ASM_GLOBAL .globl
/// ///
/// A pointer to a function in IPF points to a plabel. /// A pointer to a function in IPF points to a plabel.
/// ///
@ -418,7 +412,7 @@ typedef struct {
/** /**
Return the pointer to the first instruction of a function given a function pointer. Return the pointer to the first instruction of a function given a function pointer.
For Itanium CPUs, all function calls are made through a PLABEL, so a pointer to a function For Itanium processors, all function calls are made through a PLABEL, so a pointer to a function
is actually a pointer to a PLABEL. The pointer to the first instruction of the function is actually a pointer to a PLABEL. The pointer to the first instruction of the function
is contained within the PLABEL. This macro may be used to retrieve a pointer to the first is contained within the PLABEL. This macro may be used to retrieve a pointer to the first
instruction of a function independent of the CPU architecture being used. This is very instruction of a function independent of the CPU architecture being used. This is very

162
MdePkg/Include/Library/BaseLib.h
View File

@ -1,6 +1,6 @@
/** @file /** @file
Provides string functions, linked list functions, math functions, synchronization Provides string functions, linked list functions, math functions, synchronization
functions, and CPU architecture specific functions. functions, and CPU architecture-specific functions.
Copyright (c) 2006 - 2008, Intel Corporation<BR> Copyright (c) 2006 - 2008, Intel Corporation<BR>
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
@ -17,11 +17,11 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
#define __BASE_LIB__ #define __BASE_LIB__
// //
// Definitions for architecture specific types // Definitions for architecture-specific types
// //
#if defined (MDE_CPU_IA32) #if defined (MDE_CPU_IA32)
/// ///
/// IA32 context buffer used by SetJump() and LongJump() /// IA-32 architecture context buffer used by SetJump() and LongJump()
/// ///
typedef struct { typedef struct {
UINT32 Ebx; UINT32 Ebx;
@ -39,7 +39,7 @@ typedef struct {
#if defined (MDE_CPU_IPF) #if defined (MDE_CPU_IPF)
/// ///
/// IPF context buffer used by SetJump() and LongJump() /// Itanium architecture context buffer used by SetJump() and LongJump()
/// ///
typedef struct { typedef struct {
UINT64 F2[2]; UINT64 F2[2];
@ -88,7 +88,7 @@ typedef struct {
#if defined (MDE_CPU_X64) #if defined (MDE_CPU_X64)
/// ///
/// x64 context buffer used by SetJump() and LongJump() /// x64 architecture context buffer used by SetJump() and LongJump()
/// ///
typedef struct { typedef struct {
UINT64 Rbx; UINT64 Rbx;
@ -3159,7 +3159,7 @@ MemoryFence (
calls to LongJump() cause a non-zero value to be returned by SetJump(). calls to LongJump() cause a non-zero value to be returned by SetJump().
If JumpBuffer is NULL, then ASSERT(). If JumpBuffer is NULL, then ASSERT().
For IPF CPUs, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT(). For Itanium processors, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT().
NOTE: The structure BASE_LIBRARY_JUMP_BUFFER is CPU architecture specific. NOTE: The structure BASE_LIBRARY_JUMP_BUFFER is CPU architecture specific.
The same structure must never be used for more than one CPU architecture context. The same structure must never be used for more than one CPU architecture context.
@ -3186,7 +3186,7 @@ SetJump (
the state of JumpBuffer. the state of JumpBuffer.
If JumpBuffer is NULL, then ASSERT(). If JumpBuffer is NULL, then ASSERT().
For IPF CPUs, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT(). For Itanium processors, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT().
If Value is 0, then ASSERT(). If Value is 0, then ASSERT().
@param JumpBuffer A pointer to CPU context buffer. @param JumpBuffer A pointer to CPU context buffer.
@ -3311,8 +3311,8 @@ CpuPause (
by Context1 and Context2. Context1 and Context2 are optional and may by Context1 and Context2. Context1 and Context2 are optional and may
be NULL. The function EntryPoint must never return. This function be NULL. The function EntryPoint must never return. This function
supports a variable number of arguments following the NewStack parameter. supports a variable number of arguments following the NewStack parameter.
These additional arguments are ignored on IA-32, x64, and EBC. These additional arguments are ignored on IA-32, x64, and EBC architectures.
IPF CPUs expect one additional parameter of type VOID * that specifies Itanium processors expect one additional parameter of type VOID * that specifies
the new backing store pointer. the new backing store pointer.
If EntryPoint is NULL, then ASSERT(). If EntryPoint is NULL, then ASSERT().
@ -3325,8 +3325,8 @@ CpuPause (
function. function.
@param NewStack A pointer to the new stack to use for the EntryPoint @param NewStack A pointer to the new stack to use for the EntryPoint
function. function.
@param ... This variable argument list is ignored for IA32, x64, and EBC. @param ... This variable argument list is ignored for IA-32, x64, and EBC architectures.
For IPF, this variable argument list is expected to contain For Itanium processors, this variable argument list is expected to contain
a single parameter of type VOID * that specifies the new backing a single parameter of type VOID * that specifies the new backing
store pointer. store pointer.
@ -3384,7 +3384,7 @@ CpuDeadLoop (
line containing Address + Length - 1 is flushed. This function may choose to flush line containing Address + Length - 1 is flushed. This function may choose to flush
the entire cache if that is more efficient than flushing the specified range. If the entire cache if that is more efficient than flushing the specified range. If
Length is 0, the no cache lines are flushed. Address is returned. Length is 0, the no cache lines are flushed. Address is returned.
This function is only available on IPF. This function is only available on Itanium processors.
If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT(). If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
@ -3410,7 +3410,7 @@ AsmFlushCacheRange (
Executes a FC instruction Executes a FC instruction
Executes a FC instruction on the cache line specified by Address. Executes a FC instruction on the cache line specified by Address.
The cache line size affected is at least 32-bytes (aligned on a 32-byte boundary). The cache line size affected is at least 32-bytes (aligned on a 32-byte boundary).
An implementation may flush a larger region. This function is only available on IPF. An implementation may flush a larger region. This function is only available on Itanium processors.
@param Address The Address of cache line to be flushed. @param Address The Address of cache line to be flushed.
@ -3428,7 +3428,7 @@ AsmFc (
Executes a FC.I instruction. Executes a FC.I instruction.
Executes a FC.I instruction on the cache line specified by Address. Executes a FC.I instruction on the cache line specified by Address.
The cache line size affected is at least 32-bytes (aligned on a 32-byte boundary). The cache line size affected is at least 32-bytes (aligned on a 32-byte boundary).
An implementation may flush a larger region. This function is only available on IPF. An implementation may flush a larger region. This function is only available on Itanium processors.
@param Address The Address of cache line to be flushed. @param Address The Address of cache line to be flushed.
@ -3451,7 +3451,7 @@ AsmFci (
No parameter checking is performed on Index. If the Index value is beyond the No parameter checking is performed on Index. If the Index value is beyond the
implemented CPUID register range, a Reserved Register/Field fault may occur. The caller implemented CPUID register range, a Reserved Register/Field fault may occur. The caller
must either guarantee that Index is valid, or the caller must set up fault handlers to must either guarantee that Index is valid, or the caller must set up fault handlers to
catch the faults. This function is only available on IPF. catch the faults. This function is only available on Itanium processors.
@param Index The 8-bit Processor Identifier Register index to read. @param Index The 8-bit Processor Identifier Register index to read.
@ -3467,7 +3467,7 @@ AsmReadCpuid (
/** /**
Reads the current value of 64-bit Processor Status Register (PSR). Reads the current value of 64-bit Processor Status Register (PSR).
This function is only available on IPF. This function is only available on Itanium processors.
@return The current value of PSR. @return The current value of PSR.
@ -3485,7 +3485,7 @@ AsmReadPsr (
No parameter checking is performed on Value. All bits of Value corresponding to No parameter checking is performed on Value. All bits of Value corresponding to
reserved fields of PSR must be 0 or a Reserved Register/Field fault may occur. reserved fields of PSR must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults. This function is only available on IPF. fault handlers to catch the faults. This function is only available on Itanium processors.
@param Value The 64-bit value to write to PSR. @param Value The 64-bit value to write to PSR.
@ -3503,7 +3503,7 @@ AsmWritePsr (
Reads the current value of 64-bit Kernel Register #0 (KR0). Reads the current value of 64-bit Kernel Register #0 (KR0).
Reads and returns the current value of KR0. Reads and returns the current value of KR0.
This function is only available on IPF. This function is only available on Itanium processors.
@return The current value of KR0. @return The current value of KR0.
@ -3519,7 +3519,7 @@ AsmReadKr0 (
Reads the current value of 64-bit Kernel Register #1 (KR1). Reads the current value of 64-bit Kernel Register #1 (KR1).
Reads and returns the current value of KR1. Reads and returns the current value of KR1.
This function is only available on IPF. This function is only available on Itanium processors.
@return The current value of KR1. @return The current value of KR1.
@ -3535,7 +3535,7 @@ AsmReadKr1 (
Reads the current value of 64-bit Kernel Register #2 (KR2). Reads the current value of 64-bit Kernel Register #2 (KR2).
Reads and returns the current value of KR2. Reads and returns the current value of KR2.
This function is only available on IPF. This function is only available on Itanium processors.
@return The current value of KR2. @return The current value of KR2.
@ -3551,7 +3551,7 @@ AsmReadKr2 (
Reads the current value of 64-bit Kernel Register #3 (KR3). Reads the current value of 64-bit Kernel Register #3 (KR3).
Reads and returns the current value of KR3. Reads and returns the current value of KR3.
This function is only available on IPF. This function is only available on Itanium processors.
@return The current value of KR3. @return The current value of KR3.
@ -3567,7 +3567,7 @@ AsmReadKr3 (
Reads the current value of 64-bit Kernel Register #4 (KR4). Reads the current value of 64-bit Kernel Register #4 (KR4).
Reads and returns the current value of KR4. Reads and returns the current value of KR4.
This function is only available on IPF. This function is only available on Itanium processors.
@return The current value of KR4. @return The current value of KR4.
@ -3583,7 +3583,7 @@ AsmReadKr4 (
Reads the current value of 64-bit Kernel Register #5 (KR5). Reads the current value of 64-bit Kernel Register #5 (KR5).
Reads and returns the current value of KR5. Reads and returns the current value of KR5.
This function is only available on IPF. This function is only available on Itanium processors.
@return The current value of KR5. @return The current value of KR5.
@ -3599,7 +3599,7 @@ AsmReadKr5 (
Reads the current value of 64-bit Kernel Register #6 (KR6). Reads the current value of 64-bit Kernel Register #6 (KR6).
Reads and returns the current value of KR6. Reads and returns the current value of KR6.
This function is only available on IPF. This function is only available on Itanium processors.
@return The current value of KR6. @return The current value of KR6.
@ -3615,7 +3615,7 @@ AsmReadKr6 (
Reads the current value of 64-bit Kernel Register #7 (KR7). Reads the current value of 64-bit Kernel Register #7 (KR7).
Reads and returns the current value of KR7. Reads and returns the current value of KR7.
This function is only available on IPF. This function is only available on Itanium processors.
@return The current value of KR7. @return The current value of KR7.
@ -3631,7 +3631,7 @@ AsmReadKr7 (
Write the current value of 64-bit Kernel Register #0 (KR0). Write the current value of 64-bit Kernel Register #0 (KR0).
Writes the current value of KR0. The 64-bit value written to Writes the current value of KR0. The 64-bit value written to
the KR0 is returned. This function is only available on IPF. the KR0 is returned. This function is only available on Itanium processors.
@param Value The 64-bit value to write to KR0. @param Value The 64-bit value to write to KR0.
@ -3649,7 +3649,7 @@ AsmWriteKr0 (
Write the current value of 64-bit Kernel Register #1 (KR1). Write the current value of 64-bit Kernel Register #1 (KR1).
Writes the current value of KR1. The 64-bit value written to Writes the current value of KR1. The 64-bit value written to
the KR1 is returned. This function is only available on IPF. the KR1 is returned. This function is only available on Itanium processors.
@param Value The 64-bit value to write to KR1. @param Value The 64-bit value to write to KR1.
@ -3667,7 +3667,7 @@ AsmWriteKr1 (
Write the current value of 64-bit Kernel Register #2 (KR2). Write the current value of 64-bit Kernel Register #2 (KR2).
Writes the current value of KR2. The 64-bit value written to Writes the current value of KR2. The 64-bit value written to
the KR2 is returned. This function is only available on IPF. the KR2 is returned. This function is only available on Itanium processors.
@param Value The 64-bit value to write to KR2. @param Value The 64-bit value to write to KR2.
@ -3685,7 +3685,7 @@ AsmWriteKr2 (
Write the current value of 64-bit Kernel Register #3 (KR3). Write the current value of 64-bit Kernel Register #3 (KR3).
Writes the current value of KR3. The 64-bit value written to Writes the current value of KR3. The 64-bit value written to
the KR3 is returned. This function is only available on IPF. the KR3 is returned. This function is only available on Itanium processors.
@param Value The 64-bit value to write to KR3. @param Value The 64-bit value to write to KR3.
@ -3703,7 +3703,7 @@ AsmWriteKr3 (
Write the current value of 64-bit Kernel Register #4 (KR4). Write the current value of 64-bit Kernel Register #4 (KR4).
Writes the current value of KR4. The 64-bit value written to Writes the current value of KR4. The 64-bit value written to
the KR4 is returned. This function is only available on IPF. the KR4 is returned. This function is only available on Itanium processors.
@param Value The 64-bit value to write to KR4. @param Value The 64-bit value to write to KR4.
@ -3721,7 +3721,7 @@ AsmWriteKr4 (
Write the current value of 64-bit Kernel Register #5 (KR5). Write the current value of 64-bit Kernel Register #5 (KR5).
Writes the current value of KR5. The 64-bit value written to Writes the current value of KR5. The 64-bit value written to
the KR5 is returned. This function is only available on IPF. the KR5 is returned. This function is only available on Itanium processors.
@param Value The 64-bit value to write to KR5. @param Value The 64-bit value to write to KR5.
@ -3739,7 +3739,7 @@ AsmWriteKr5 (
Write the current value of 64-bit Kernel Register #6 (KR6). Write the current value of 64-bit Kernel Register #6 (KR6).
Writes the current value of KR6. The 64-bit value written to Writes the current value of KR6. The 64-bit value written to
the KR6 is returned. This function is only available on IPF. the KR6 is returned. This function is only available on Itanium processors.
@param Value The 64-bit value to write to KR6. @param Value The 64-bit value to write to KR6.
@ -3757,7 +3757,7 @@ AsmWriteKr6 (
Write the current value of 64-bit Kernel Register #7 (KR7). Write the current value of 64-bit Kernel Register #7 (KR7).
Writes the current value of KR7. The 64-bit value written to Writes the current value of KR7. The 64-bit value written to
the KR7 is returned. This function is only available on IPF. the KR7 is returned. This function is only available on Itanium processors.
@param Value The 64-bit value to write to KR7. @param Value The 64-bit value to write to KR7.
@ -3775,7 +3775,7 @@ AsmWriteKr7 (
Reads the current value of Interval Timer Counter Register (ITC). Reads the current value of Interval Timer Counter Register (ITC).
Reads and returns the current value of ITC. Reads and returns the current value of ITC.
This function is only available on IPF. This function is only available on Itanium processors.
@return The current value of ITC. @return The current value of ITC.
@ -3791,7 +3791,7 @@ AsmReadItc (
Reads the current value of Interval Timer Vector Register (ITV). Reads the current value of Interval Timer Vector Register (ITV).
Reads and returns the current value of ITV. Reads and returns the current value of ITV.
This function is only available on IPF. This function is only available on Itanium processors.
@return The current value of ITV. @return The current value of ITV.
@ -3807,7 +3807,7 @@ AsmReadItv (
Reads the current value of Interval Timer Match Register (ITM). Reads the current value of Interval Timer Match Register (ITM).
Reads and returns the current value of ITM. Reads and returns the current value of ITM.
This function is only available on IPF. This function is only available on Itanium processors.
@return The current value of ITM. @return The current value of ITM.
**/ **/
@ -3822,7 +3822,7 @@ AsmReadItm (
Writes the current value of 64-bit Interval Timer Counter Register (ITC). Writes the current value of 64-bit Interval Timer Counter Register (ITC).
Writes the current value of ITC. The 64-bit value written to the ITC is returned. Writes the current value of ITC. The 64-bit value written to the ITC is returned.
This function is only available on IPF. This function is only available on Itanium processors.
@param Value The 64-bit value to write to ITC. @param Value The 64-bit value to write to ITC.
@ -3840,7 +3840,7 @@ AsmWriteItc (
Writes the current value of 64-bit Interval Timer Match Register (ITM). Writes the current value of 64-bit Interval Timer Match Register (ITM).
Writes the current value of ITM. The 64-bit value written to the ITM is returned. Writes the current value of ITM. The 64-bit value written to the ITM is returned.
This function is only available on IPF. This function is only available on Itanium processors.
@param Value The 64-bit value to write to ITM. @param Value The 64-bit value to write to ITM.
@ -3862,7 +3862,7 @@ AsmWriteItm (
reserved fields of ITV must be 0 or a Reserved Register/Field fault may occur. reserved fields of ITV must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults. fault handlers to catch the faults.
This function is only available on IPF. This function is only available on Itanium processors.
@param Value The 64-bit value to write to ITV. @param Value The 64-bit value to write to ITV.
@ -3879,7 +3879,7 @@ AsmWriteItv (
/** /**
Reads the current value of Default Control Register (DCR). Reads the current value of Default Control Register (DCR).
Reads and returns the current value of DCR. This function is only available on IPF. Reads and returns the current value of DCR. This function is only available on Itanium processors.
@return The current value of DCR. @return The current value of DCR.
@ -3894,7 +3894,7 @@ AsmReadDcr (
/** /**
Reads the current value of Interruption Vector Address Register (IVA). Reads the current value of Interruption Vector Address Register (IVA).
Reads and returns the current value of IVA. This function is only available on IPF. Reads and returns the current value of IVA. This function is only available on Itanium processors.
@return The current value of IVA. @return The current value of IVA.
**/ **/
@ -3908,7 +3908,7 @@ AsmReadIva (
/** /**
Reads the current value of Page Table Address Register (PTA). Reads the current value of Page Table Address Register (PTA).
Reads and returns the current value of PTA. This function is only available on IPF. Reads and returns the current value of PTA. This function is only available on Itanium processors.
@return The current value of PTA. @return The current value of PTA.
@ -3928,7 +3928,7 @@ AsmReadPta (
reserved fields of DCR must be 0 or a Reserved Register/Field fault may occur. reserved fields of DCR must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults. fault handlers to catch the faults.
This function is only available on IPF. This function is only available on Itanium processors.
@param Value The 64-bit value to write to DCR. @param Value The 64-bit value to write to DCR.
@ -3948,7 +3948,7 @@ AsmWriteDcr (
Writes the current value of IVA. The 64-bit value written to the IVA is returned. Writes the current value of IVA. The 64-bit value written to the IVA is returned.
The size of vector table is 32 K bytes and is 32 K bytes aligned The size of vector table is 32 K bytes and is 32 K bytes aligned
the low 15 bits of Value is ignored when written. the low 15 bits of Value is ignored when written.
This function is only available on IPF. This function is only available on Itanium processors.
@param Value The 64-bit value to write to IVA. @param Value The 64-bit value to write to IVA.
@ -3970,7 +3970,7 @@ AsmWriteIva (
reserved fields of DCR must be 0 or a Reserved Register/Field fault may occur. reserved fields of DCR must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults. fault handlers to catch the faults.
This function is only available on IPF. This function is only available on Itanium processors.
@param Value The 64-bit value to write to PTA. @param Value The 64-bit value to write to PTA.
@ -3986,7 +3986,7 @@ AsmWritePta (
/** /**
Reads the current value of Local Interrupt ID Register (LID). Reads the current value of Local Interrupt ID Register (LID).
Reads and returns the current value of LID. This function is only available on IPF. Reads and returns the current value of LID. This function is only available on Itanium processors.
@return The current value of LID. @return The current value of LID.
@ -4001,7 +4001,7 @@ AsmReadLid (
/** /**
Reads the current value of External Interrupt Vector Register (IVR). Reads the current value of External Interrupt Vector Register (IVR).
Reads and returns the current value of IVR. This function is only available on IPF. Reads and returns the current value of IVR. This function is only available on Itanium processors.
@return The current value of IVR. @return The current value of IVR.
@ -4016,7 +4016,7 @@ AsmReadIvr (
/** /**
Reads the current value of Task Priority Register (TPR). Reads the current value of Task Priority Register (TPR).
Reads and returns the current value of TPR. This function is only available on IPF. Reads and returns the current value of TPR. This function is only available on Itanium processors.
@return The current value of TPR. @return The current value of TPR.
@ -4031,7 +4031,7 @@ AsmReadTpr (
/** /**
Reads the current value of External Interrupt Request Register #0 (IRR0). Reads the current value of External Interrupt Request Register #0 (IRR0).
Reads and returns the current value of IRR0. This function is only available on IPF. Reads and returns the current value of IRR0. This function is only available on Itanium processors.
@return The current value of IRR0. @return The current value of IRR0.
@ -4046,7 +4046,7 @@ AsmReadIrr0 (
/** /**
Reads the current value of External Interrupt Request Register #1 (IRR1). Reads the current value of External Interrupt Request Register #1 (IRR1).
Reads and returns the current value of IRR1. This function is only available on IPF. Reads and returns the current value of IRR1. This function is only available on Itanium processors.
@return The current value of IRR1. @return The current value of IRR1.
@ -4061,7 +4061,7 @@ AsmReadIrr1 (
/** /**
Reads the current value of External Interrupt Request Register #2 (IRR2). Reads the current value of External Interrupt Request Register #2 (IRR2).
Reads and returns the current value of IRR2. This function is only available on IPF. Reads and returns the current value of IRR2. This function is only available on Itanium processors.
@return The current value of IRR2. @return The current value of IRR2.
@ -4076,7 +4076,7 @@ AsmReadIrr2 (
/** /**
Reads the current value of External Interrupt Request Register #3 (IRR3). Reads the current value of External Interrupt Request Register #3 (IRR3).
Reads and returns the current value of IRR3. This function is only available on IPF. Reads and returns the current value of IRR3. This function is only available on Itanium processors.
@return The current value of IRR3. @return The current value of IRR3.
@ -4091,7 +4091,7 @@ AsmReadIrr3 (
/** /**
Reads the current value of Performance Monitor Vector Register (PMV). Reads the current value of Performance Monitor Vector Register (PMV).
Reads and returns the current value of PMV. This function is only available on IPF. Reads and returns the current value of PMV. This function is only available on Itanium processors.
@return The current value of PMV. @return The current value of PMV.
@ -4106,7 +4106,7 @@ AsmReadPmv (
/** /**
Reads the current value of Corrected Machine Check Vector Register (CMCV). Reads the current value of Corrected Machine Check Vector Register (CMCV).
Reads and returns the current value of CMCV. This function is only available on IPF. Reads and returns the current value of CMCV. This function is only available on Itanium processors.
@return The current value of CMCV. @return The current value of CMCV.
@ -4121,7 +4121,7 @@ AsmReadCmcv (
/** /**
Reads the current value of Local Redirection Register #0 (LRR0). Reads the current value of Local Redirection Register #0 (LRR0).
Reads and returns the current value of LRR0. This function is only available on IPF. Reads and returns the current value of LRR0. This function is only available on Itanium processors.
@return The current value of LRR0. @return The current value of LRR0.
@ -4136,7 +4136,7 @@ AsmReadLrr0 (
/** /**
Reads the current value of Local Redirection Register #1 (LRR1). Reads the current value of Local Redirection Register #1 (LRR1).
Reads and returns the current value of LRR1. This function is only available on IPF. Reads and returns the current value of LRR1. This function is only available on Itanium processors.
@return The current value of LRR1. @return The current value of LRR1.
@ -4156,7 +4156,7 @@ AsmReadLrr1 (
reserved fields of LID must be 0 or a Reserved Register/Field fault may occur. reserved fields of LID must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults. fault handlers to catch the faults.
This function is only available on IPF. This function is only available on Itanium processors.
@param Value The 64-bit value to write to LID. @param Value The 64-bit value to write to LID.
@ -4178,7 +4178,7 @@ AsmWriteLid (
reserved fields of TPR must be 0 or a Reserved Register/Field fault may occur. reserved fields of TPR must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults. fault handlers to catch the faults.
This function is only available on IPF. This function is only available on Itanium processors.
@param Value The 64-bit value to write to TPR. @param Value The 64-bit value to write to TPR.
@ -4195,7 +4195,7 @@ AsmWriteTpr (
/** /**
Performs a write operation on End OF External Interrupt Register (EOI). Performs a write operation on End OF External Interrupt Register (EOI).
Writes a value of 0 to the EOI Register. This function is only available on IPF. Writes a value of 0 to the EOI Register. This function is only available on Itanium processors.
**/ **/
VOID VOID
@ -4213,7 +4213,7 @@ AsmWriteEoi (
to reserved fields of PMV must be 0 or a Reserved Register/Field fault may occur. to reserved fields of PMV must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults. fault handlers to catch the faults.
This function is only available on IPF. This function is only available on Itanium processors.
@param Value The 64-bit value to write to PMV. @param Value The 64-bit value to write to PMV.
@ -4235,7 +4235,7 @@ AsmWritePmv (
to reserved fields of CMCV must be 0 or a Reserved Register/Field fault may occur. to reserved fields of CMCV must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults. fault handlers to catch the faults.
This function is only available on IPF. This function is only available on Itanium processors.
@param Value The 64-bit value to write to CMCV. @param Value The 64-bit value to write to CMCV.
@ -4257,7 +4257,7 @@ AsmWriteCmcv (
to reserved fields of LRR0 must be 0 or a Reserved Register/Field fault may occur. to reserved fields of LRR0 must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults. fault handlers to catch the faults.
This function is only available on IPF. This function is only available on Itanium processors.
@param Value The 64-bit value to write to LRR0. @param Value The 64-bit value to write to LRR0.
@ -4279,7 +4279,7 @@ AsmWriteLrr0 (
to reserved fields of LRR1 must be 0 or a Reserved Register/Field fault may occur. to reserved fields of LRR1 must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must The caller must either guarantee that Value is valid, or the caller must
set up fault handlers to catch the faults. set up fault handlers to catch the faults.
This function is only available on IPF. This function is only available on Itanium processors.
@param Value The 64-bit value to write to LRR1. @param Value The 64-bit value to write to LRR1.
@ -4304,7 +4304,7 @@ AsmWriteLrr1 (
is beyond the implemented IBR register range, a Reserved Register/Field fault may is beyond the implemented IBR register range, a Reserved Register/Field fault may
occur. The caller must either guarantee that Index is valid, or the caller must occur. The caller must either guarantee that Index is valid, or the caller must
set up fault handlers to catch the faults. set up fault handlers to catch the faults.
This function is only available on IPF. This function is only available on Itanium processors.
@param Index The 8-bit Instruction Breakpoint Register index to read. @param Index The 8-bit Instruction Breakpoint Register index to read.
@ -4329,7 +4329,7 @@ AsmReadIbr (
the implemented DBR register range, a Reserved Register/Field fault may occur. the implemented DBR register range, a Reserved Register/Field fault may occur.
The caller must either guarantee that Index is valid, or the caller must set up The caller must either guarantee that Index is valid, or the caller must set up
fault handlers to catch the faults. fault handlers to catch the faults.
This function is only available on IPF. This function is only available on Itanium processors.
@param Index The 8-bit Data Breakpoint Register index to read. @param Index The 8-bit Data Breakpoint Register index to read.
@ -4354,7 +4354,7 @@ AsmReadDbr (
register set is implementation dependent. No parameter checking is performed register set is implementation dependent. No parameter checking is performed
on Index. If the Index value is beyond the implemented PMC register range, on Index. If the Index value is beyond the implemented PMC register range,
zero value will be returned. zero value will be returned.
This function is only available on IPF. This function is only available on Itanium processors.
@param Index The 8-bit Performance Monitor Configuration Register index to read. @param Index The 8-bit Performance Monitor Configuration Register index to read.
@ -4380,7 +4380,7 @@ AsmReadPmc (
register set is implementation dependent. No parameter checking is performed register set is implementation dependent. No parameter checking is performed
on Index. If the Index value is beyond the implemented PMD register range, on Index. If the Index value is beyond the implemented PMD register range,
zero value will be returned. zero value will be returned.
This function is only available on IPF. This function is only available on Itanium processors.
@param Index The 8-bit Performance Monitor Data Register index to read. @param Index The 8-bit Performance Monitor Data Register index to read.
@ -4406,7 +4406,7 @@ AsmReadPmd (
is beyond the implemented IBR register range, a Reserved Register/Field fault may is beyond the implemented IBR register range, a Reserved Register/Field fault may
occur. The caller must either guarantee that Index is valid, or the caller must occur. The caller must either guarantee that Index is valid, or the caller must
set up fault handlers to catch the faults. set up fault handlers to catch the faults.
This function is only available on IPF. This function is only available on Itanium processors.
@param Index The 8-bit Instruction Breakpoint Register index to write. @param Index The 8-bit Instruction Breakpoint Register index to write.
@param Value The 64-bit value to write to IBR. @param Value The 64-bit value to write to IBR.
@ -4434,7 +4434,7 @@ AsmWriteIbr (
DBR register range, a Reserved Register/Field fault may occur. The caller must DBR register range, a Reserved Register/Field fault may occur. The caller must
either guarantee that Index is valid, or the caller must set up fault handlers to either guarantee that Index is valid, or the caller must set up fault handlers to
catch the faults. catch the faults.
This function is only available on IPF. This function is only available on Itanium processors.
@param Index The 8-bit Data Breakpoint Register index to write. @param Index The 8-bit Data Breakpoint Register index to write.
@param Value The 64-bit value to write to DBR. @param Value The 64-bit value to write to DBR.
@ -4461,7 +4461,7 @@ AsmWriteDbr (
counters (PMC/PMD pairs). The remainder of PMC and PMD register set is implementation counters (PMC/PMD pairs). The remainder of PMC and PMD register set is implementation
dependent. No parameter checking is performed on Index. If the Index value is dependent. No parameter checking is performed on Index. If the Index value is
beyond the implemented PMC register range, the write is ignored. beyond the implemented PMC register range, the write is ignored.
This function is only available on IPF. This function is only available on Itanium processors.
@param Index The 8-bit Performance Monitor Configuration Register index to write. @param Index The 8-bit Performance Monitor Configuration Register index to write.
@param Value The 64-bit value to write to PMC. @param Value The 64-bit value to write to PMC.
@ -4488,7 +4488,7 @@ AsmWritePmc (
performance counters (PMC/PMD pairs). The remainder of PMC and PMD register set performance counters (PMC/PMD pairs). The remainder of PMC and PMD register set
is implementation dependent. No parameter checking is performed on Index. If the is implementation dependent. No parameter checking is performed on Index. If the
Index value is beyond the implemented PMD register range, the write is ignored. Index value is beyond the implemented PMD register range, the write is ignored.
This function is only available on IPF. This function is only available on Itanium processors.
@param Index The 8-bit Performance Monitor Data Register index to write. @param Index The 8-bit Performance Monitor Data Register index to write.
@param Value The 64-bit value to write to PMD. @param Value The 64-bit value to write to PMD.
@ -4508,7 +4508,7 @@ AsmWritePmd (
Reads the current value of 64-bit Global Pointer (GP). Reads the current value of 64-bit Global Pointer (GP).
Reads and returns the current value of GP. Reads and returns the current value of GP.
This function is only available on IPF. This function is only available on Itanium processors.
@return The current value of GP. @return The current value of GP.
@ -4525,7 +4525,7 @@ AsmReadGp (
Writes the current value of GP. The 64-bit value written to the GP is returned. Writes the current value of GP. The 64-bit value written to the GP is returned.
No parameter checking is performed on Value. No parameter checking is performed on Value.
This function is only available on IPF. This function is only available on Itanium processors.
@param Value The 64-bit value to write to GP. @param Value The 64-bit value to write to GP.
@ -4543,7 +4543,7 @@ AsmWriteGp (
Reads the current value of 64-bit Stack Pointer (SP). Reads the current value of 64-bit Stack Pointer (SP).
Reads and returns the current value of SP. Reads and returns the current value of SP.
This function is only available on IPF. This function is only available on Itanium processors.
@return The current value of SP. @return The current value of SP.
@ -4590,7 +4590,7 @@ AsmReadSp (
Reads and returns the control register specified by Index. The valid Index valued are defined Reads and returns the control register specified by Index. The valid Index valued are defined
above in "Related Definitions". above in "Related Definitions".
If Index is invalid then 0xFFFFFFFFFFFFFFFF is returned. This function is only available on IPF. If Index is invalid then 0xFFFFFFFFFFFFFFFF is returned. This function is only available on Itanium processors.
@param Index The index of the control register to read. @param Index The index of the control register to read.
@ -4640,7 +4640,7 @@ AsmReadControlRegister (
Reads and returns the application register specified by Index. The valid Index valued are defined Reads and returns the application register specified by Index. The valid Index valued are defined
above in "Related Definitions". above in "Related Definitions".
If Index is invalid then 0xFFFFFFFFFFFFFFFF is returned. This function is only available on IPF. If Index is invalid then 0xFFFFFFFFFFFFFFFF is returned. This function is only available on Itanium processors.
@param Index The index of the application register to read. @param Index The index of the application register to read.
@ -4661,7 +4661,7 @@ AsmReadApplicationRegister (
parameter checking is performed on Index, and if the Index value is beyond the implemented MSR parameter checking is performed on Index, and if the Index value is beyond the implemented MSR
register range, a Reserved Register/Field fault may occur. The caller must either guarantee that register range, a Reserved Register/Field fault may occur. The caller must either guarantee that
Index is valid, or the caller must set up fault handlers to catch the faults. This function is Index is valid, or the caller must set up fault handlers to catch the faults. This function is
only available on IPF. only available on Itanium processors.
@param Index The 8-bit Machine Specific Register index to read. @param Index The 8-bit Machine Specific Register index to read.
@ -4682,7 +4682,7 @@ AsmReadMsr (
parameter checking is performed on Index, and if the Index value is beyond the implemented MSR parameter checking is performed on Index, and if the Index value is beyond the implemented MSR
register range, a Reserved Register/Field fault may occur. The caller must either guarantee that register range, a Reserved Register/Field fault may occur. The caller must either guarantee that
Index is valid, or the caller must set up fault handlers to catch the faults. This function is Index is valid, or the caller must set up fault handlers to catch the faults. This function is
only available on IPF. only available on Itanium processors.
@param Index The 8-bit Machine Specific Register index to write. @param Index The 8-bit Machine Specific Register index to write.
@param Value The 64-bit value to write to the Machine Specific Register. @param Value The 64-bit value to write to the Machine Specific Register.
@ -4706,7 +4706,7 @@ AsmWriteMsr (
If the CPU is in physical mode(PSR.RT=0, PSR.DT=0, PSR.IT=0), then 0 is returned. If the CPU is in physical mode(PSR.RT=0, PSR.DT=0, PSR.IT=0), then 0 is returned.
If the CPU is not in physical mode or virtual mode, then it is in mixed mode, If the CPU is not in physical mode or virtual mode, then it is in mixed mode,
and -1 is returned. and -1 is returned.
This function is only available on IPF. This function is only available on Itanium processors.
@retval 1 The CPU is in virtual mode. @retval 1 The CPU is in virtual mode.
@retval 0 The CPU is in physical mode. @retval 0 The CPU is in physical mode.
@ -4740,7 +4740,7 @@ AsmCpuVirtual (
argument return value may be returned or undefined result may occur during the argument return value may be returned or undefined result may occur during the
execution of the procedure. If the PalEntryPoint does not point to a valid execution of the procedure. If the PalEntryPoint does not point to a valid
PAL entry point then the system behavior is undefined. This function is only PAL entry point then the system behavior is undefined. This function is only
available on IPF. available on Itanium processors.
@param PalEntryPoint The PAL procedure calls entry point. @param PalEntryPoint The PAL procedure calls entry point.
@param Index The PAL procedure Index number. @param Index The PAL procedure Index number.
@ -4894,7 +4894,7 @@ typedef struct {
#if defined (MDE_CPU_IA32) #if defined (MDE_CPU_IA32)
/// ///
/// Byte packed structure for an IA32 Interrupt Gate Descriptor /// Byte packed structure for an IA-32 Interrupt Gate Descriptor
/// ///
typedef union { typedef union {
struct { struct {

6
MdePkg/Include/Library/CacheMaintenanceLib.h
View File

@ -39,7 +39,7 @@ InvalidateInstructionCache (
aligned on a cache line boundary, then the entire instruction cache line aligned on a cache line boundary, then the entire instruction cache line
containing Address + Length -1 is invalidated. This function may choose to containing Address + Length -1 is invalidated. This function may choose to
invalidate the entire instruction cache if that is more efficient than invalidate the entire instruction cache if that is more efficient than
invalidating the specified range. If Length is 0, the no instruction cache invalidating the specified range. If Length is 0, then no instruction cache
lines are invalidated. Address is returned. lines are invalidated. Address is returned.
If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT(). If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
@ -88,7 +88,7 @@ WriteBackInvalidateDataCache (
line containing Address + Length -1 is written back and invalidated. This line containing Address + Length -1 is written back and invalidated. This
function may choose to write back and invalidate the entire data cache if function may choose to write back and invalidate the entire data cache if
that is more efficient than writing back and invalidating the specified that is more efficient than writing back and invalidating the specified
range. If Length is 0, the no data cache lines are written back and range. If Length is 0, then no data cache lines are written back and
invalidated. Address is returned. invalidated. Address is returned.
If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT(). If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
@ -136,7 +136,7 @@ WriteBackDataCache (
cache line boundary, then the entire data cache line containing Address + cache line boundary, then the entire data cache line containing Address +
Length -1 is written back. This function may choose to write back the entire Length -1 is written back. This function may choose to write back the entire
data cache if that is more efficient than writing back the specified range. data cache if that is more efficient than writing back the specified range.
If Length is 0, the no data cache lines are written back. This function may If Length is 0, then no data cache lines are written back. This function may
also invalidate all the data cache lines in the specified range of the cache also invalidate all the data cache lines in the specified range of the cache
coherency domain of the calling CPU. Address is returned. coherency domain of the calling CPU. Address is returned.

2
MdePkg/Include/Library/CpuLib.h
View File

@ -3,7 +3,7 @@
in the Base Library due to dependencies on the PAL Library in the Base Library due to dependencies on the PAL Library
The CPU Library provides services to flush CPU TLBs and place the CPU in a sleep state. The CPU Library provides services to flush CPU TLBs and place the CPU in a sleep state.
The implementation of these services on Itanium CPUs requires the use of PAL Calls. The implementation of these services on Itanium processors requires the use of PAL Calls.
PAL Calls require PEI and DXE specific mechanisms to look up PAL Entry Point. PAL Calls require PEI and DXE specific mechanisms to look up PAL Entry Point.
As a result, these services could not be defined in the Base Library. As a result, these services could not be defined in the Base Library.

8
MdePkg/Include/Library/DebugLib.h
View File

@ -216,10 +216,10 @@ DebugClearMemoryEnabled (
/** /**
Internal worker macro that calls DebugAssert(). Internal worker macro that calls DebugAssert().
This macro calls DebugAssert() passing in the filename, line number, and This macro calls DebugAssert(), passing in the filename, line number, and an
expression that evailated to FALSE. expression that evaluated to FALSE.
@param Expression Boolean expression that evailated to FALSE @param Expression Boolean expression that evaluated to FALSE
**/ **/
#define _ASSERT(Expression) DebugAssert (__FILE__, __LINE__, #Expression) #define _ASSERT(Expression) DebugAssert (__FILE__, __LINE__, #Expression)
@ -239,7 +239,7 @@ DebugClearMemoryEnabled (
/** /**
Macro that calls DebugAssert() if a expression evaluates to FALSE. Macro that calls DebugAssert() if an expression evaluates to FALSE.
If the DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit of PcdDebugProperyMask is set, If the DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit of PcdDebugProperyMask is set,
then this macro evaluates the Boolean expression specified by Expression. If then this macro evaluates the Boolean expression specified by Expression. If

19
MdePkg/Include/Library/DxeServicesLib.h
View File

@ -13,14 +13,17 @@
**/ **/
#ifndef __DXE_SERVICES_LIB_H__ #ifndef __PI_LIB_H__
#define __DXE_SERVICES_LIB_H__ #define __PI_LIB_H__
#include <Pi/PiFirmwareFile.h>
/** /**
Searches all the availables firmware volumes and returns the first matching FFS section. Searches all the available firmware volumes and returns the first matching FFS section.
This function searches all the firmware volumes for FFS files with an FFS filename specified by NameGuid. This function searches all the firmware volumes for FFS files with an FFS filename specified by NameGuid.
The order that the firmware volumes is searched is not deterministic. For each FFS file found a search The order in which the firmware volumes are searched is not deterministic. For each FFS file found, a search
is made for FFS sections of type SectionType. If the FFS file contains at least SectionInstance instances is made for FFS sections of type SectionType. If the FFS file contains at least SectionInstance instances
of the FFS section specified by SectionType, then the SectionInstance instance is returned in Buffer. of the FFS section specified by SectionType, then the SectionInstance instance is returned in Buffer.
Buffer is allocated using AllocatePool(), and the size of the allocated buffer is returned in Size. Buffer is allocated using AllocatePool(), and the size of the allocated buffer is returned in Size.
@ -42,7 +45,7 @@
@param SectionType Indicates the FFS section type to search for within the FFS file specified by NameGuid. @param SectionType Indicates the FFS section type to search for within the FFS file specified by NameGuid.
@param SectionInstance Indicates which section instance within the FFS file specified by NameGuid to retrieve. @param SectionInstance Indicates which section instance within the FFS file specified by NameGuid to retrieve.
@param Buffer On output, a pointer to a callee allocated buffer containing the FFS file section that was found. @param Buffer On output, a pointer to a callee allocated buffer containing the FFS file section that was found.
Is it the caller's responsibility to free this buffer using FreePool(). It is the caller's responsibility to free this buffer using FreePool().
@param Size On output, a pointer to the size, in bytes, of Buffer. @param Size On output, a pointer to the size, in bytes, of Buffer.
@retval EFI_SUCCESS The specified FFS section was returned. @retval EFI_SUCCESS The specified FFS section was returned.
@ -66,7 +69,7 @@ GetSectionFromAnyFv (
Searches the firmware volume that the currently executing module was loaded from and returns the first matching FFS section. Searches the firmware volume that the currently executing module was loaded from and returns the first matching FFS section.
This function searches the firmware volume that the currently executing module was loaded This function searches the firmware volume that the currently executing module was loaded
from for an FFS file with an FFS filename specified by NameGuid. If the FFS file is found a search from for an FFS file with an FFS filename specified by NameGuid. If the FFS file is found, a search
is made for FFS sections of type SectionType. If the FFS file contains at least SectionInstance is made for FFS sections of type SectionType. If the FFS file contains at least SectionInstance
instances of the FFS section specified by SectionType, then the SectionInstance instance is returned in Buffer. instances of the FFS section specified by SectionType, then the SectionInstance instance is returned in Buffer.
Buffer is allocated using AllocatePool(), and the size of the allocated buffer is returned in Size. Buffer is allocated using AllocatePool(), and the size of the allocated buffer is returned in Size.
@ -88,7 +91,7 @@ GetSectionFromAnyFv (
@param SectionType Indicates the FFS section type to search for within the FFS file specified by NameGuid. @param SectionType Indicates the FFS section type to search for within the FFS file specified by NameGuid.
@param SectionInstance Indicates which section instance within the FFS file specified by NameGuid to retrieve. @param SectionInstance Indicates which section instance within the FFS file specified by NameGuid to retrieve.
@param Buffer On output, a pointer to a callee allocated buffer containing the FFS file section that was found. @param Buffer On output, a pointer to a callee allocated buffer containing the FFS file section that was found.
Is it the caller's responsibility to free this buffer using FreePool(). It is the caller's responsibility to free this buffer using FreePool().
@param Size On output, a pointer to the size, in bytes, of Buffer. @param Size On output, a pointer to the size, in bytes, of Buffer.
@ -134,7 +137,7 @@ GetSectionFromFv (
@param SectionInstance Indicates which section instance to retrieve within the FFS file @param SectionInstance Indicates which section instance to retrieve within the FFS file
that the currently executing module was loaded from. that the currently executing module was loaded from.
@param Buffer On output, a pointer to a callee allocated buffer containing the FFS file section that was found. @param Buffer On output, a pointer to a callee allocated buffer containing the FFS file section that was found.
Is it the caller's responsibility to free this buffer using FreePool(). It is the caller's responsibility to free this buffer using FreePool().
@param Size On output, a pointer to the size, in bytes, of Buffer. @param Size On output, a pointer to the size, in bytes, of Buffer.
@retval EFI_SUCCESS The specified FFS section was returned. @retval EFI_SUCCESS The specified FFS section was returned.

8
MdePkg/Include/Library/PalLib.h
View File

@ -2,12 +2,12 @@
Provides library services to make PAL Calls. Provides library services to make PAL Calls.
The PAL Library provides a service to make a PAL CALL. This service is identical The PAL Library provides a service to make a PAL CALL. This service is identical
in functionality to AsmPalCall() in the Itanium specific functions of the Base Library. in functionality to AsmPalCall() in the functions of the Base Library specific to Intel Itanium architecture.
The only difference is that the PAL Entry Point is not passed in. Implementations The only difference is that the PAL Entry Point is not passed in. Implementations
of this library class must manage PAL Entry Point on their own. For example, a PEI of this library class must manage PAL Entry Point on their own. For example, a PEI
implementation can use a PPI to lookup the PAL Entry Point, and a DXE implementation implementation can use a PPI to lookup the PAL Entry Point, and a DXE implementation
can contain a constructor to look up the PAL Entry Point from a HOB. This library class can contain a constructor to look up the PAL Entry Point from a HOB. This library class
is only available on IPF. is only available on Intel Itanium-based platforms.
Copyright (c) 2006 - 2008, Intel Corporation<BR> Copyright (c) 2006 - 2008, Intel Corporation<BR>
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
@ -40,7 +40,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
may cause undefined results. For those parameters defined as reserved or some fields may cause undefined results. For those parameters defined as reserved or some fields
defined as reserved must be zero filled or the invalid argument return value may be defined as reserved must be zero filled or the invalid argument return value may be
returned or undefined result may occur during the execution of the procedure. returned or undefined result may occur during the execution of the procedure.
This function is only available on IPF. This function is only available on Intel Itanium-based platforms.
@param Index The PAL procedure Index number. @param Index The PAL procedure Index number.
@param Arg2 The 2nd parameter for PAL procedure calls. @param Arg2 The 2nd parameter for PAL procedure calls.

44
MdePkg/Include/Library/PcdLib.h
View File

@ -1,12 +1,12 @@
/** @file /** @file
Provides library services to get and set Platform Configuration Database entries. Provides library services to get and set Platform Configuration Database entries.
PCD Library Class provides PCD usage macro interface for all PCD types. PCD Library Class provides a PCD usage macro interface for all PCD types.
It should be included at any module who use PCD. If module use dynamic/dynamicex It should be included in any module that uses PCD. If a module uses dynamic/dynamicex
PCD, module should be linked to PEIM/DXE library instance to access that PCD. PCD, module should be linked to a PEIM/DXE library instance to access that PCD.
If module uses PatchableInModule type PCD, also need library instance produce If a module uses PatchableInModule type PCD, it also needs the library instance to produce
LibPatchPcdSetPtr() interface. For FeatureFlag/Fixed PCD, macro interface is LibPatchPcdSetPtr() interface. For FeatureFlag/Fixed PCD, the macro interface is
translated to an variable or macro which is auto-generated by build tool in translated to n variable or macro that is auto-generated by build tool in
module's autogen.h/autogen.c. module's autogen.h/autogen.c.
The PcdGetXX(), PcdSetXX(), PcdToken(), and PcdGetNextTokenSpace() operations are The PcdGetXX(), PcdSetXX(), PcdToken(), and PcdGetNextTokenSpace() operations are
only available prior to ExitBootServices(). If access to PCD values are required only available prior to ExitBootServices(). If access to PCD values are required
@ -785,7 +785,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
@param SkuId The SKU value that will be used when the PCD service retrieves and sets values @param SkuId The SKU value that will be used when the PCD service retrieves and sets values
associated with a PCD token. associated with a PCD token.
@return Return the SKU ID that just be set. @return Return the SKU ID that was set.
**/ **/
UINTN UINTN
@ -1072,7 +1072,7 @@ LibPcdGetExSize (
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 8-bit value to set. @param[in] Value The 8-bit value to set.
@return Return the value been set. @return Return the value that was set.
**/ **/
UINT8 UINT8
@ -1092,7 +1092,7 @@ LibPcdSet8 (
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 16-bit value to set. @param[in] Value The 16-bit value to set.
@return Return the value been set. @return Return the value that was set.
**/ **/
UINT16 UINT16
@ -1112,7 +1112,7 @@ LibPcdSet16 (
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 32-bit value to set. @param[in] Value The 32-bit value to set.
@return Return the value been set. @return Return the value that was set.
**/ **/
UINT32 UINT32
@ -1132,7 +1132,7 @@ LibPcdSet32 (
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 64-bit value to set. @param[in] Value The 64-bit value to set.
@return Return the value been set. @return Return the value that was set.
**/ **/
UINT64 UINT64
@ -1162,7 +1162,7 @@ LibPcdSet64 (
@param[in, out] SizeOfBuffer The size, in bytes, of Buffer. @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to set. @param[in] Buffer A pointer to the buffer to set.
@return Return the pointer for the buffer been set. @return Return the pointer for the buffer that was set.
**/ **/
VOID * VOID *
@ -1183,7 +1183,7 @@ LibPcdSetPtr (
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The boolean value to set. @param[in] Value The boolean value to set.
@return Return the value been set. @return Return the value that was set.
**/ **/
BOOLEAN BOOLEAN
@ -1207,7 +1207,7 @@ LibPcdSetBool (
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 8-bit value to set. @param[in] Value The 8-bit value to set.
@return Return the value been set. @return Return the value that was set.
**/ **/
UINT8 UINT8
@ -1232,7 +1232,7 @@ LibPcdSetEx8 (
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 16-bit value to set. @param[in] Value The 16-bit value to set.
@return Return the value been set. @return Return the value that was set.
**/ **/
UINT16 UINT16
@ -1257,7 +1257,7 @@ LibPcdSetEx16 (
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 32-bit value to set. @param[in] Value The 32-bit value to set.
@return Return the value been set. @return Return the value that was set.
**/ **/
UINT32 UINT32
@ -1281,7 +1281,7 @@ LibPcdSetEx32 (
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 64-bit value to set. @param[in] Value The 64-bit value to set.
@return Return the value been set. @return Return the value that was set.
**/ **/
UINT64 UINT64
@ -1312,7 +1312,7 @@ LibPcdSetEx64 (
@param[in, out] SizeOfBuffer The size, in bytes, of Buffer. @param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to set. @param[in] Buffer A pointer to the buffer to set.
@return Return the pinter to the buffer been set. @return Return the pointer to the buffer that was set.
**/ **/
VOID * VOID *
@ -1338,7 +1338,7 @@ LibPcdSetExPtr (
@param[in] TokenNumber The PCD token number to set a current value for. @param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The Boolean value to set. @param[in] Value The Boolean value to set.
@return Return the value been set. @return Return the value that was set.
**/ **/
BOOLEAN BOOLEAN
@ -1353,9 +1353,9 @@ LibPcdSetExBool (
/** /**
This notification function serves two purposes. This notification function serves two purposes.
Firstly, it notifies the module which did the registration that the value of this Firstly, it notifies the module that did the registration that the value of this
PCD token has been set. PCD token has been set.
Secondly, it provides a mechanism for the module which did the registration to intercept Secondly, it provides a mechanism for the module that did the registration to intercept
the set operation and override the value been set if necessary. After the invocation of the set operation and override the value been set if necessary. After the invocation of
the callback function, TokenData will be used by PCD service PEIM or driver to modify th the callback function, TokenData will be used by PCD service PEIM or driver to modify th
internal data in PCD database. internal data in PCD database.
@ -1491,7 +1491,7 @@ LibPcdGetNextTokenSpace (
@param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer. @param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable. @param[in] Buffer A pointer to the buffer to used to set the target variable.
@return Return the pointer to the buffer been set. @return Return the pointer to the buffer that was set.
**/ **/
VOID * VOID *

2
MdePkg/Include/Library/PciCf8Lib.h
View File

@ -2,7 +2,7 @@
Provides services to access PCI Configuration Space using the I/O ports 0xCF8 and 0xCFC. Provides services to access PCI Configuration Space using the I/O ports 0xCF8 and 0xCFC.
This library is identical to the PCI Library, except the access method for performing PCI This library is identical to the PCI Library, except the access method for performing PCI
configuration cycles must be though I/O ports 0xCF8 and 0xCFC. This library only allows configuration cycles must be through I/O ports 0xCF8 and 0xCFC. This library only allows
access to PCI Segment #0. access to PCI Segment #0.
Copyright (c) 2006 - 2009, Intel Corporation<BR> Copyright (c) 2006 - 2009, Intel Corporation<BR>

2
MdePkg/Include/Library/PciExpressLib.h
View File

@ -2,7 +2,7 @@
Provides services to access PCI Configuration Space using the MMIO PCI Express window. Provides services to access PCI Configuration Space using the MMIO PCI Express window.
This library is identical to the PCI Library, except the access method for performing PCI This library is identical to the PCI Library, except the access method for performing PCI
configuration cycles must be though the 256 MB PCI Express MMIO window whose base address configuration cycles must be through the 256 MB PCI Express MMIO window whose base address
is defined by PcdPciExpressBaseAddress. is defined by PcdPciExpressBaseAddress.
Copyright (c) 2006 - 2008, Intel Corporation<BR> Copyright (c) 2006 - 2008, Intel Corporation<BR>

2
MdePkg/Include/Library/PciLib.h
View File

@ -167,7 +167,7 @@ PciAnd8 (
/** /**
Performs a bitwise AND of an 8-bit PCI configuration register with an 8-bit Performs a bitwise AND of an 8-bit PCI configuration register with an 8-bit
value, followed a bitwise OR with another 8-bit value. value, followed by a bitwise OR with another 8-bit value.
Reads the 8-bit PCI configuration register specified by Address, performs a Reads the 8-bit PCI configuration register specified by Address, performs a
bitwise AND between the read result and the value specified by AndData, bitwise AND between the read result and the value specified by AndData,

10
MdePkg/Include/Library/PeCoffLib.h
View File

@ -2,7 +2,7 @@
Provides services to load and relocate a PE/COFF image. Provides services to load and relocate a PE/COFF image.
The PE/COFF Loader Library abstracts the implementation of a PE/COFF loader for The PE/COFF Loader Library abstracts the implementation of a PE/COFF loader for
IA-32, x86, IPF, and EBC processor types. The library functions are memory based IA-32, x86, IPF, and EBC processor types. The library functions are memory-based
and can be ported easily to any environment. and can be ported easily to any environment.
Copyright (c) 2006 - 2008, Intel Corporation Copyright (c) 2006 - 2008, Intel Corporation
@ -230,7 +230,7 @@ PeCoffLoaderGetImageInfo (
of ImageContext as the relocation base address. The caller must allocate the relocation of ImageContext as the relocation base address. The caller must allocate the relocation
fixup log buffer and fill in the FixupData field of ImageContext prior to calling this function. fixup log buffer and fill in the FixupData field of ImageContext prior to calling this function.
The ImageRead, Handle, PeCoffHeaderOffset, IsTeImage, Machine, ImageType, ImageAddress, The ImageRead, Handle, PeCoffHeaderOffset, IsTeImage, Machine, ImageType, ImageAddress,
ImageSize, DestinationAddress, RelocationsStripped, SectionAlignment, SizeOfHeaders, ImageSize, DestinationAddress, RelocationsStripped, SectionAlignment, SizeOfHeaders,
DebugDirectoryEntryRva, EntryPoint, FixupDataSize, CodeView, PdbPointer, and FixupData of DebugDirectoryEntryRva, EntryPoint, FixupDataSize, CodeView, PdbPointer, and FixupData of
the ImageContext structure must be valid prior to invoking this service. the ImageContext structure must be valid prior to invoking this service.
@ -265,7 +265,7 @@ PeCoffLoaderRelocateImage (
specified by the ImageAddress and ImageSize fields of ImageContext. The caller must allocate specified by the ImageAddress and ImageSize fields of ImageContext. The caller must allocate
the load buffer and fill in the ImageAddress and ImageSize fields prior to calling this function. the load buffer and fill in the ImageAddress and ImageSize fields prior to calling this function.
The EntryPoint, FixupDataSize, CodeView, PdbPointer and HiiResourceData fields of ImageContext are computed. The EntryPoint, FixupDataSize, CodeView, PdbPointer and HiiResourceData fields of ImageContext are computed.
The ImageRead, Handle, PeCoffHeaderOffset, IsTeImage, Machine, ImageType, ImageAddress, ImageSize, The ImageRead, Handle, PeCoffHeaderOffset, IsTeImage, Machine, ImageType, ImageAddress, ImageSize,
DestinationAddress, RelocationsStripped, SectionAlignment, SizeOfHeaders, and DebugDirectoryEntryRva DestinationAddress, RelocationsStripped, SectionAlignment, SizeOfHeaders, and DebugDirectoryEntryRva
fields of the ImageContext structure must be valid prior to invoking this service. fields of the ImageContext structure must be valid prior to invoking this service.
@ -302,7 +302,7 @@ PeCoffLoaderLoadImage (
This is the default implementation of a PE_COFF_LOADER_READ_FILE function This is the default implementation of a PE_COFF_LOADER_READ_FILE function
that assumes FileHandle pointer to the beginning of a PE/COFF image. that assumes FileHandle pointer to the beginning of a PE/COFF image.
This function reads contents of the PE/COFF image that starts at the system memory This function reads contents of the PE/COFF image that starts at the system memory
address specified by FileHandle. The read operation copies ReadSize bytes from the address specified by FileHandle. The read operation copies ReadSize bytes from the
PE/COFF image starting at byte offset FileOffset into the buffer specified by Buffer. PE/COFF image starting at byte offset FileOffset into the buffer specified by Buffer.
The size of the buffer actually read is returned in ReadSize. The size of the buffer actually read is returned in ReadSize.
@ -335,7 +335,7 @@ PeCoffLoaderImageReadFromMemory (
This function reapplies relocation fixups to the PE/COFF image specified by ImageBase This function reapplies relocation fixups to the PE/COFF image specified by ImageBase
and ImageSize so the image will execute correctly when the PE/COFF image is mapped and ImageSize so the image will execute correctly when the PE/COFF image is mapped
to the address specified by VirtualImageBase. RelocationData must be identical to the address specified by VirtualImageBase. RelocationData must be identical
to the FiuxupData buffer from the PE_COFF_LOADER_IMAGE_CONTEXT structure to the FiuxupData buffer from the PE_COFF_LOADER_IMAGE_CONTEXT structure
after this PE/COFF image was relocated with PeCoffLoaderRelocateImage(). after this PE/COFF image was relocated with PeCoffLoaderRelocateImage().

4
MdePkg/Include/Library/PeiCoreEntryPoint.h
View File

@ -86,8 +86,8 @@ EfiMain (
module depends on. This include library instances that a module depends on directly and library module depends on. This include library instances that a module depends on directly and library
instances that a module depends on indirectly through other libraries. instances that a module depends on indirectly through other libraries.
This function is autogenerated by build tools and those build tools are responsible for collecting This function is autogenerated by build tools and those build tools are responsible for collecting
the set of library instances, determine which ones have constructors, and calling the library the set of library instances, determining which ones have constructors, and calling the library
constructors in the proper order based upon each of the library instances own dependencies. constructors in the proper order based upon the dependencies of each of the library instances.
The PEI Core must call this function with a NULL FileHandle value as soon as the initial PEI The PEI Core must call this function with a NULL FileHandle value as soon as the initial PEI
Services Table has been established. Services Table has been established.

10
MdePkg/Include/Library/PostCodeLib.h
View File

@ -19,7 +19,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
#define POST_CODE_PROPERTY_POST_CODE_DESCRIPTION_ENABLED 0x00000010 #define POST_CODE_PROPERTY_POST_CODE_DESCRIPTION_ENABLED 0x00000010
/** /**
Sends an 32-bit value to a POST card. Sends a 32-bit value to a POST card.
Sends the 32-bit value specified by Value to a POST card, and returns Value. Sends the 32-bit value specified by Value to a POST card, and returns Value.
Some implementations of this library function may perform I/O operations Some implementations of this library function may perform I/O operations
@ -28,7 +28,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
display the 32-bit value on the status reporting device. display the 32-bit value on the status reporting device.
PostCode() must actively prevent recursion. If PostCode() is called while PostCode() must actively prevent recursion. If PostCode() is called while
processing another any other Post Code Library function, then processing another Post Code Library function, then
PostCode() must return Value immediately. PostCode() must return Value immediately.
@param Value The 32-bit value to write to the POST card. @param Value The 32-bit value to write to the POST card.
@ -44,7 +44,7 @@ PostCode (
/** /**
Sends an 32-bit value to a POST and associated ASCII string. Sends a 32-bit value to a POST and associated ASCII string.
Sends the 32-bit value specified by Value to a POST card, and returns Value. Sends the 32-bit value specified by Value to a POST card, and returns Value.
If Description is not NULL, then the ASCII string specified by Description is If Description is not NULL, then the ASCII string specified by Description is
@ -114,7 +114,7 @@ PostCodeDescriptionEnabled (
/** /**
Sends an 32-bit value to a POST card. Sends a 32-bit value to a POST card.
If POST codes are enabled in PcdPostCodeProperyMask, then call PostCode() If POST codes are enabled in PcdPostCodeProperyMask, then call PostCode()
passing in Value. Value is returned. passing in Value. Value is returned.
@ -127,7 +127,7 @@ PostCodeDescriptionEnabled (
#define POST_CODE(Value) PostCodeEnabled() ? PostCode(Value) : Value #define POST_CODE(Value) PostCodeEnabled() ? PostCode(Value) : Value
/** /**
Sends an 32-bit value to a POST and associated ASCII string. Sends a 32-bit value to a POST and associated ASCII string.
If POST codes and POST code descriptions are enabled in If POST codes and POST code descriptions are enabled in
PcdPostCodeProperyMask, then call PostCodeWithDescription() passing in PcdPostCodeProperyMask, then call PostCodeWithDescription() passing in

2
MdePkg/Include/Library/SalLib.h
View File

@ -29,7 +29,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
defined as reserved or some fields defined as reserved must be defined as reserved or some fields defined as reserved must be
zero filled or the invalid argument return value may be returned zero filled or the invalid argument return value may be returned
or undefined result may occur during the execution of the procedure. or undefined result may occur during the execution of the procedure.
This function is only available on IPF. This function is only available on Intel Itanium-based platforms.
@param Index The SAL procedure Index number @param Index The SAL procedure Index number
@param Arg2 The 2nd parameter for SAL procedure calls @param Arg2 The 2nd parameter for SAL procedure calls

2
MdePkg/Include/Library/SerialPortLib.h
View File

@ -69,7 +69,7 @@ SerialPortWrite (
@param Buffer Pointer to the data buffer to store the data read from the serial device. @param Buffer Pointer to the data buffer to store the data read from the serial device.
@param NumberOfBytes Number of bytes which will be read. @param NumberOfBytes Number of bytes which will be read.
@retval 0 Read data failed, No data is to be read. @retval 0 Read data failed, no data is to be read.
@retval >0 Actual number of bytes read from serial device. @retval >0 Actual number of bytes read from serial device.
**/ **/

8
MdePkg/Include/Library/SynchronizationLib.h
View File

@ -22,7 +22,7 @@ typedef volatile UINTN SPIN_LOCK;
/** /**
Retrieves the architecture specific spin lock alignment requirements for Retrieves the architecture-specific spin lock alignment requirements for
optimal spin lock performance. optimal spin lock performance.
This function retrieves the spin lock alignment requirements for optimal This function retrieves the spin lock alignment requirements for optimal
@ -34,7 +34,7 @@ typedef volatile UINTN SPIN_LOCK;
consumers of the spin lock synchronization functions to obtain optimal spin consumers of the spin lock synchronization functions to obtain optimal spin
lock performance. lock performance.
@return The architecture specific spin lock alignment. @return The architecture-specific spin lock alignment.
**/ **/
UINTN UINTN
@ -140,7 +140,7 @@ ReleaseSpinLock (
/** /**
Performs an atomic increment of an 32-bit unsigned integer. Performs an atomic increment of a 32-bit unsigned integer.
Performs an atomic increment of the 32-bit unsigned integer specified by Performs an atomic increment of the 32-bit unsigned integer specified by
Value and returns the incremented value. The increment operation must be Value and returns the incremented value. The increment operation must be
@ -162,7 +162,7 @@ InterlockedIncrement (
/** /**
Performs an atomic decrement of an 32-bit unsigned integer. Performs an atomic decrement of a 32-bit unsigned integer.
Performs an atomic decrement of the 32-bit unsigned integer specified by Performs an atomic decrement of the 32-bit unsigned integer specified by
Value and returns the decremented value. The decrement operation must be Value and returns the decremented value. The decrement operation must be

2
MdePkg/Include/Library/UefiDecompressLib.h
View File

@ -45,7 +45,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
@param SourceSize The size, in bytes, of the source buffer. @param SourceSize The size, in bytes, of the source buffer.
@param DestinationSize A pointer to the size, in bytes, of the uncompressed buffer @param DestinationSize A pointer to the size, in bytes, of the uncompressed buffer
that will be generated when the compressed buffer specified that will be generated when the compressed buffer specified
by Source and SourceSize is decompressed.. by Source and SourceSize is decompressed.
@param ScratchSize A pointer to the size, in bytes, of the scratch buffer that @param ScratchSize A pointer to the size, in bytes, of the scratch buffer that
is required to decompress the compressed buffer specified is required to decompress the compressed buffer specified
by Source and SourceSize. by Source and SourceSize.

28
MdePkg/Include/Library/UefiLib.h
View File

@ -113,8 +113,8 @@ typedef struct {
based on a specified GUID. based on a specified GUID.
This function searches the list of configuration tables stored in the EFI System Table This function searches the list of configuration tables stored in the EFI System Table
for a table with a GUID that matches TableGuid. If a match is found, then a pointer to for a table with a GUID that matches TableGuid. If a match is found, then a pointer to
the configuration table is returned in Table., and EFI_SUCCESS is returned. If a matching GUID the configuration table is returned in Table, and EFI_SUCCESS is returned. If a matching GUID
is not found, then EFI_NOT_FOUND is returned. is not found, then EFI_NOT_FOUND is returned.
If TableGuid is NULL, then ASSERT(). If TableGuid is NULL, then ASSERT().
If Table is NULL, then ASSERT(). If Table is NULL, then ASSERT().
@ -948,7 +948,7 @@ EfiInitializeFwVolDevicepathNode (
This library function abstracts validating a device path node. This library function abstracts validating a device path node.
Check the MEDIA_FW_VOL_FILEPATH_DEVICE_PATH data structure to see if it's valid. Check the MEDIA_FW_VOL_FILEPATH_DEVICE_PATH data structure to see if it's valid.
If it is valid, then return the GUID file name from the device path node. Otherwise, If it is valid, then return the GUID file name from the device path node. Otherwise,
return NULL. This device path changed in the DXE CIS version 0.92 in a non back ward return NULL. This device path changed in the DXE CIS version 0.92 in a non backward
compatible way to not conflict with the UEFI 2.0 specification. This function abstracts compatible way to not conflict with the UEFI 2.0 specification. This function abstracts
the differences from the caller. the differences from the caller.
If FvDevicePathNode is NULL, then ASSERT(). If FvDevicePathNode is NULL, then ASSERT().
@ -1077,12 +1077,10 @@ AsciiErrorPrint (
Unicode characters displayed, not including partial characters that may be clipped Unicode characters displayed, not including partial characters that may be clipped
by the right edge of the display. If the length of the formatted Unicode string is by the right edge of the display. If the length of the formatted Unicode string is
greater than PcdUefiLibMaxPrintBufferSize, then at most the first greater than PcdUefiLibMaxPrintBufferSize, then at most the first
PcdUefiLibMaxPrintBufferSize characters are printed.The EFI_HII_FONT_PROTOCOL PcdUefiLibMaxPrintBufferSize characters are printed. The EFI_HII_FONT_PROTOCOL
StringToImage() service is used to convert the string to a bitmap using the glyphs is used to convert the string to a bitmap using the glyphs registered with the
registered with the HII database. No wrapping is performed, so any portions of the HII database. No wrapping is performed, so any portions of the string the fall
string the fall outside the active display region will not be displayed. Please see outside the active display region will not be displayed.
Section 27.2.6 of the UEFI Specification for a description of the supported string
format including the set of control codes supported by the StringToImage() service.
If a graphics console device is not associated with the ConsoleOutputHandle If a graphics console device is not associated with the ConsoleOutputHandle
defined in the EFI_SYSTEM_TABLE then no string is printed, and 0 is returned. defined in the EFI_SYSTEM_TABLE then no string is printed, and 0 is returned.
@ -1129,12 +1127,10 @@ PrintXY (
ASCII characters displayed, not including partial characters that may be clipped ASCII characters displayed, not including partial characters that may be clipped
by the right edge of the display. If the length of the formatted ASCII string is by the right edge of the display. If the length of the formatted ASCII string is
greater than PcdUefiLibMaxPrintBufferSize, then at most the first greater than PcdUefiLibMaxPrintBufferSize, then at most the first
PcdUefiLibMaxPrintBufferSize characters are printed.The EFI_HII_FONT_PROTOCOL PcdUefiLibMaxPrintBufferSize characters are printed. The EFI_HII_FONT_PROTOCOL
StringToImage() service is used to convert the string to a bitmap using the glyphs is used to convert the string to a bitmap using the glyphs registered with the
registered with the HII database. No wrapping is performed, so any portions of the HII database. No wrapping is performed, so any portions of the string the fall
string the fall outside the active display region will not be displayed. Please see outside the active display region will not be displayed.
Section 27.2.6 of the UEFI Specification for a description of the supported string
format including the set of control codes supported by the StringToImage() service.
If a graphics console device is not associated with the ConsoleOutputHandle If a graphics console device is not associated with the ConsoleOutputHandle
defined in the EFI_SYSTEM_TABLE then no string is printed, and 0 is returned. defined in the EFI_SYSTEM_TABLE then no string is printed, and 0 is returned.
@ -1210,7 +1206,7 @@ EfiLibInstallDriverBinding (
Initializes a driver by installing the Driver Binding Protocol together with the Initializes a driver by installing the Driver Binding Protocol together with the
optional Component Name, optional Driver Configure and optional Driver Diagnostic optional Component Name, optional Driver Configure and optional Driver Diagnostic
Protocols onto the driver's DriverBindingHandle. If DriverBindingHandle is NULL, Protocols onto the driver's DriverBindingHandle. If DriverBindingHandle is NULL,
then the protocols are installed onto a newly created handle. DriverBindingHandle then the protocols are installed onto a newly created handle. DriverBindingHandle
is typically the same as the driver's ImageHandle, but it can be different if the is typically the same as the driver's ImageHandle, but it can be different if the
driver produces multiple Driver Binding Protocols. driver produces multiple Driver Binding Protocols.
If DriverBinding is NULL, then ASSERT(). If DriverBinding is NULL, then ASSERT().

10
MdePkg/Include/Library/UefiRuntimeLib.h
View File

@ -60,7 +60,7 @@ EfiGoneVirtual (
information returned by GetTime() are the values that were last set via SetTime(). information returned by GetTime() are the values that were last set via SetTime().
The GetTime() function should take approximately the same amount of time to read the time each The GetTime() function should take approximately the same amount of time to read the time each
time it is called. All reported device capabilities are to be rounded up. time it is called. All reported device capabilities are to be rounded up.
During runtime, if a PC-AT CMOS device is present in the platform the caller must synchronize During runtime, if a PC-AT CMOS device is present in the platform, the caller must synchronize
access to the device before calling GetTime(). access to the device before calling GetTime().
@param Time A pointer to storage to receive a snapshot of the current time. @param Time A pointer to storage to receive a snapshot of the current time.
@ -87,7 +87,7 @@ EfiGetTime (
to loop based on the current time. For example, if the device does not support a hardware reset to loop based on the current time. For example, if the device does not support a hardware reset
for the sub-resolution time, the code is not to implement the feature by waiting for the time to for the sub-resolution time, the code is not to implement the feature by waiting for the time to
wrap. wrap.
During runtime, if a PC-AT CMOS device is present in the platform the caller must synchronize During runtime, if a PC-AT CMOS device is present in the platform, the caller must synchronize
access to the device before calling SetTime(). access to the device before calling SetTime().
@param Time A pointer to the current time. Type EFI_TIME is defined in the GetTime() @param Time A pointer to the current time. Type EFI_TIME is defined in the GetTime()
@ -169,7 +169,7 @@ EfiSetWakeupTime (
This service is a wrapper for the UEFI Runtime Service GetVariable(). This service is a wrapper for the UEFI Runtime Service GetVariable().
Each vendor may create and manage its own variables without the risk of name conflicts by Each vendor may create and manage its own variables without the risk of name conflicts by
using a unique VendorGuid. When a variable is set its Attributes are supplied to indicate using a unique VendorGuid. When a variable is set, its Attributes are supplied to indicate
how the data variable should be stored and maintained by the system. The attributes affect how the data variable should be stored and maintained by the system. The attributes affect
when the variable may be accessed and volatility of the data. Any attempts to access a variable when the variable may be accessed and volatility of the data. Any attempts to access a variable
that does not have the attribute set for runtime access will yield the EFI_NOT_FOUND error. that does not have the attribute set for runtime access will yield the EFI_NOT_FOUND error.
@ -249,7 +249,7 @@ EfiGetNextVariableName (
Variables are stored by the firmware and may maintain their values across power cycles. Each vendor Variables are stored by the firmware and may maintain their values across power cycles. Each vendor
may create and manage its own variables without the risk of name conflicts by using a unique VendorGuid. may create and manage its own variables without the risk of name conflicts by using a unique VendorGuid.
@param VariableName the name of the vendor's variable, it's a @param VariableName the name of the vendor's variable, as a
Null-Terminated Unicode String Null-Terminated Unicode String
@param VendorGuid Unify identifier for vendor. @param VendorGuid Unify identifier for vendor.
@param Attributes Point to memory location to return the attributes of variable. If the point @param Attributes Point to memory location to return the attributes of variable. If the point
@ -443,7 +443,7 @@ EfiSetVirtualAddressMap (
@param ListHead Head of linked list to convert. @param ListHead Head of linked list to convert.
@retval EFI_SUCCESS Success to execute the function. @retval EFI_SUCCESS Success to execute the function.
@retval !EFI_SUCCESS Failed to e3xecute the function. @retval !EFI_SUCCESS Failed to execute the function.
**/ **/
EFI_STATUS EFI_STATUS

2
MdePkg/Include/Library/UefiScsiLib.h
View File

@ -1,5 +1,5 @@
/** @file /** @file
Provides the functions to submit Scsi commands defined in SCSI-2 specification for scsi device. Provides the functions to submit Scsi commands defined in SCSI-2 specification for SCSI devices.
This library class provides the functions to submit SCSI commands defined in SCSI-2 specification This library class provides the functions to submit SCSI commands defined in SCSI-2 specification
for hard drive, CD and DVD devices that are the most common SCSI boot targets used by UEFI platforms. for hard drive, CD and DVD devices that are the most common SCSI boot targets used by UEFI platforms.

17
MdePkg/Include/Library/UefiUsbLib.h
View File

@ -1,6 +1,6 @@
/** @file /** @file
Provides most usb APIs to support the Hid requests defined in Usb Hid 1.1 spec Provides most USB APIs to support the Hid requests defined in USB Hid 1.1 spec
and the standard requests defined in Usb 1.1 spec. and the standard requests defined in USB 1.1 spec.
Copyright (c) 2006 - 2008, Intel Corporation<BR> Copyright (c) 2006 - 2008, Intel Corporation<BR>
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
@ -18,12 +18,13 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
#define __USB_DXE_LIB_H__ #define __USB_DXE_LIB_H__
#include <Protocol/UsbIo.h> #include <Protocol/UsbIo.h>
#include <IndustryStandard/Usb.h>
/** /**
Get the descriptor of the specified USB HID interface. Get the descriptor of the specified USB HID interface.
Submit a USB get HID descriptor request for the USB device specified by UsbIo Submit a UsbGetHidDescriptor() request for the USB device specified by UsbIo
and Interface and return the HID descriptor in HidDescriptor. and Interface, and return the HID descriptor in HidDescriptor.
If UsbIo is NULL, then ASSERT(). If UsbIo is NULL, then ASSERT().
If HidDescriptor is NULL, then ASSERT(). If HidDescriptor is NULL, then ASSERT().
@ -51,7 +52,7 @@ UsbGetHidDescriptor (
Get the report descriptor of the specified USB HID interface. Get the report descriptor of the specified USB HID interface.
Submit a USB get HID report descriptor request for the USB device specified by Submit a USB get HID report descriptor request for the USB device specified by
UsbIo and Interface and return the report descriptor in DescriptorBuffer. UsbIo and Interface, and return the report descriptor in DescriptorBuffer.
If UsbIo is NULL, then ASSERT(). If UsbIo is NULL, then ASSERT().
If DescriptorBuffer is NULL, then ASSERT(). If DescriptorBuffer is NULL, then ASSERT().
@ -81,7 +82,7 @@ UsbGetReportDescriptor (
Get the HID protocol of the specified USB HID interface. Get the HID protocol of the specified USB HID interface.
Submit a USB get HID protocol request for the USB device specified by UsbIo Submit a USB get HID protocol request for the USB device specified by UsbIo
and Interface and return the protocol retrieved in Protocol. and Interface, and return the protocol retrieved in Protocol.
If UsbIo is NULL, then ASSERT(). If UsbIo is NULL, then ASSERT().
If Protocol is NULL, then ASSERT(). If Protocol is NULL, then ASSERT().
@ -106,7 +107,7 @@ UsbGetProtocolRequest (
Set the HID protocol of the specified USB HID interface. Set the HID protocol of the specified USB HID interface.
Submit a USB set HID protocol request for the USB device specified by UsbIo Submit a USB set HID protocol request for the USB device specified by UsbIo
and Interface and set the protocol to the value specified by Protocol. and Interface, and set the protocol to the value specified by Protocol.
If UsbIo is NULL, then ASSERT(). If UsbIo is NULL, then ASSERT().
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target. @param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
@ -501,7 +502,7 @@ UsbClearFeature (
Get the status of the specified device. Get the status of the specified device.
Submit a USB device get status request for the USB device specified by UsbIo, Submit a USB device get status request for the USB device specified by UsbIo,
Recipient, and Target and place the result in the buffer specified by DeviceStatus. Recipient, and Target, and place the result in the buffer specified by DeviceStatus.
The status of the transfer is returned in Status. The status of the transfer is returned in Status.
If UsbIo is NULL, then ASSERT(). If UsbIo is NULL, then ASSERT().
If DeviceStatus is NULL, then ASSERT(). If DeviceStatus is NULL, then ASSERT().

6
MdePkg/Include/Ppi/Pcd.h
View File

@ -74,7 +74,7 @@ UINT8
/** /**
Retrieves a 16-bit value for a given PCD token. Retrieves a 16-bit value for a given PCD token.
Retrieves the current 16-bits value for a PCD token number. Retrieves the current 16-bit value for a PCD token number.
If the TokenNumber is invalid, the results are unpredictable. If the TokenNumber is invalid, the results are unpredictable.
@param[in] TokenNumber The PCD token number. @param[in] TokenNumber The PCD token number.
@ -93,7 +93,7 @@ UINT16
/** /**
Retrieves a 32-bit value for a given PCD token. Retrieves a 32-bit value for a given PCD token.
Retrieves the current 32-bits value for a PCD token number. Retrieves the current 32-bit value for a PCD token number.
If the TokenNumber is invalid, the results are unpredictable. If the TokenNumber is invalid, the results are unpredictable.
@param[in] TokenNumber The PCD token number. @param[in] TokenNumber The PCD token number.
@ -112,7 +112,7 @@ UINT32
/** /**
Retrieves a 64-bit value for a given PCD token. Retrieves a 64-bit value for a given PCD token.
Retrieves the current 64-bits value for a PCD token number. Retrieves the current 64-bit value for a PCD token number.
If the TokenNumber is invalid, the results are unpredictable. If the TokenNumber is invalid, the results are unpredictable.
@param[in] TokenNumber The PCD token number. @param[in] TokenNumber The PCD token number.

4
MdePkg/Include/Ppi/StatusCode.h
View File

@ -1,6 +1,6 @@
/** @file /** @file
This file declares Status Code PPI. This file declares Status Code PPI.
This ppi provides service that allows PEIMs to report status codes. This ppi provides a service that allows PEIMs to report status codes.
Copyright (c) 2006 - 2009, Intel Corporation Copyright (c) 2006 - 2009, Intel Corporation
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
@ -29,7 +29,7 @@
// //
/// ///
/// This PPI provides the sevice to report status code. /// This PPI provides the service to report status code.
/// There can be only one instance of this service in the system. /// There can be only one instance of this service in the system.
/// ///
typedef struct { typedef struct {

4
MdePkg/Include/Uefi/UefiInternalFormRepresentation.h
View File

@ -1497,7 +1497,7 @@ typedef struct {
/// ///
/// This key is affected by the caps lock so that if a keyboard driver /// This key is affected by the caps lock so that if a keyboard driver
/// would need to disambiguate between a key which had a "1" defined /// would need to disambiguate between a key which had a "1" defined
/// versus a "a" character. Having this bit turned on would tell /// versus an "a" character. Having this bit turned on would tell
/// the keyboard driver to use the appropriate shifted state or not. /// the keyboard driver to use the appropriate shifted state or not.
/// ///
#define EFI_AFFECTED_BY_CAPS_LOCK 0x0002 #define EFI_AFFECTED_BY_CAPS_LOCK 0x0002
@ -1563,7 +1563,7 @@ typedef struct {
// //
// Keys that have multiple control functions based on modifier // Keys that have multiple control functions based on modifier
// settings are handled in the keyboard driver implementation. // settings are handled in the keyboard driver implementation.
// For instance PRINT_KEY might have a modifier held down and // For instance, PRINT_KEY might have a modifier held down and
// is still a nonprinting character, but might have an alternate // is still a nonprinting character, but might have an alternate
// control function like SYSREQUEST // control function like SYSREQUEST
// //

2
MdePkg/Include/Uefi/UefiSpec.h
View File

@ -964,7 +964,7 @@ typedef enum {
/// ///
EfiResetWarm, EfiResetWarm,
/// ///
/// Used to induce en entry into power state equivalent to the ACPI G2/S5 or G3 /// Used to induce an entry into the power state equivalent to the ACPI G2/S5 or G3
/// state. If the system does not support this reset type, then when the system /// state. If the system does not support this reset type, then when the system
/// is rebooted, it should exhibit the EfiResetCold attributes. /// is rebooted, it should exhibit the EfiResetCold attributes.
/// ///

9
MdePkg/Include/X64/ProcessorBind.h
View File

@ -1,5 +1,5 @@
/** @file /** @file
Processor or Compiler specific defines and types x64 (Intel(r) EM64T, AMD64). Processor or Compiler specific defines and types x64 (Intel 64, AMD64).
Copyright (c) 2006 - 2009, Intel Corporation<BR> Copyright (c) 2006 - 2009, Intel Corporation<BR>
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
@ -397,7 +397,7 @@ typedef INT64 INTN;
#endif #endif
// //
// Macros for GNU assembly code // For symbol name in GNU assembly code, an extra "_" is necessary
// //
#if defined(__GNUC__) #if defined(__GNUC__)
#if defined(linux) #if defined(linux)
@ -405,11 +405,6 @@ typedef INT64 INTN;
#else #else
#define ASM_PFX(name) _##name #define ASM_PFX(name) _##name
#endif #endif
///
/// For GNU assembly code, .global or .globl can declare global symbols.
/// Define this macro to unify the usage.
///
#define ASM_GLOBAL .globl
#endif #endif
/** /**