/** @file\r
- This protocol defines the EFI generic memory test interfaces in Dxe phase.\r
+ This protocol defines the generic memory test interfaces in Dxe phase.\r
\r
-Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
-All rights reserved. This program and the accompanying materials\r
-are licensed and made available under the terms and conditions of the BSD License\r
-which accompanies this distribution. The full text of the license may be found at\r
-http://opensource.org/licenses/bsd-license.php\r
+Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>\r
+This program and the accompanying materials are licensed and made available under \r
+the terms and conditions of the BSD License that accompanies this distribution. \r
+The full text of the license may be found at\r
+http://opensource.org/licenses/bsd-license.php. \r
\r
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
**/\r
\r
typedef struct _EFI_GENERIC_MEMORY_TEST_PROTOCOL EFI_GENERIC_MEMORY_TEST_PROTOCOL;\r
\r
+///\r
+/// Memory test coverage level.\r
+/// Ignore chooses not to test memory. Quick and Sparse test some memory, and Extensive performs a detailed memory test.\r
+///\r
typedef enum {\r
IGNORE,\r
QUICK,\r
/**\r
Initialize the generic memory test.\r
\r
- @param This Protocol instance pointer. \r
+ @param This The protocol instance pointer. \r
@param Level The coverage level of the memory test. \r
@param RequireSoftECCInit Indicate if the memory need software ECC init. \r
\r
- @retval EFI_SUCCESS The generic memory test initialized correctly. \r
- @retval EFI_NO_MEDIA There is not any non-tested memory found, in this \r
- function if not any non-tesed memory found means \r
- that the memory test driver have not detect any \r
- non-tested extended memory of current system. \r
+ @retval EFI_SUCCESS The generic memory test is initialized correctly. \r
+ @retval EFI_NO_MEDIA The system had no memory to be tested. \r
\r
**/\r
typedef\r
EFI_STATUS\r
-(EFIAPI *EFI_MEMORY_TEST_INIT) (\r
+(EFIAPI *EFI_MEMORY_TEST_INIT)(\r
IN EFI_GENERIC_MEMORY_TEST_PROTOCOL *This,\r
IN EXTENDMEM_COVERAGE_LEVEL Level,\r
OUT BOOLEAN *RequireSoftECCInit\r
- )\r
-;\r
+ );\r
\r
\r
/**\r
Perform the memory test.\r
\r
- @param This Protocol instance pointer. \r
+ @param This The protocol instance pointer. \r
@param TestedMemorySize Return the tested extended memory size. \r
- @param TotalMemorySize Return the whole system physical memory size, this \r
- value may be changed if in some case some error \r
- DIMMs be disabled. \r
- @param ErrorOut Any time the memory error occurs, this will be \r
- TRUE. \r
- @param IfTestAbort Indicate if the user press "ESC" to skip the memory \r
- test. \r
-\r
- @retval EFI_SUCCESS One block of memory test ok, the block size is hide \r
- internally. \r
- @retval EFI_NOT_FOUND Indicate all the non-tested memory blocks have \r
- already go through. \r
- @retval EFI_DEVICE_ERROR Mis-compare error, and no agent can handle it\r
+ @param TotalMemorySize Return the whole system physical memory size. \r
+ The total memory size does not include memory in a slot with a disabled DIMM. \r
+ @param ErrorOut TRUE if the memory error occured.\r
+ @param IfTestAbort Indicates that the user pressed "ESC" to skip the memory test. \r
+\r
+ @retval EFI_SUCCESS One block of memory passed the test.\r
+ @retval EFI_NOT_FOUND All memory blocks have already been tested.\r
+ @retval EFI_DEVICE_ERROR Memory device error occured, and no agent can handle it.\r
\r
**/\r
typedef\r
EFI_STATUS\r
-(EFIAPI *EFI_PERFORM_MEMORY_TEST) (\r
- IN EFI_GENERIC_MEMORY_TEST_PROTOCOL *This,\r
+(EFIAPI *EFI_PERFORM_MEMORY_TEST)(\r
+ IN EFI_GENERIC_MEMORY_TEST_PROTOCOL *This,\r
OUT UINT64 *TestedMemorySize,\r
OUT UINT64 *TotalMemorySize,\r
OUT BOOLEAN *ErrorOut,\r
IN BOOLEAN IfTestAbort\r
- )\r
-;\r
+ );\r
\r
\r
/**\r
- The memory test finished.\r
+ Finish the memory test.\r
\r
- @param This Protocol instance pointer. \r
+ @param This The protocol instance pointer. \r
\r
- @retval EFI_SUCCESS Successful free all the generic memory test driver \r
- allocated resource and notify to platform memory \r
- test driver that memory test finished. \r
+ @retval EFI_SUCCESS Success. All resources used in the memory test are freed.\r
\r
**/\r
typedef\r
EFI_STATUS\r
-(EFIAPI *EFI_MEMORY_TEST_FINISHED) (\r
+(EFIAPI *EFI_MEMORY_TEST_FINISHED)(\r
IN EFI_GENERIC_MEMORY_TEST_PROTOCOL *This\r
- )\r
-;\r
+ );\r
\r
/**\r
- Provide capability to test compatible range which used by some sepcial\r
- driver required using memory range before BDS perform memory test.\r
+ Provides the capability to test the compatible range used by some special drivers.\r
\r
- @param This Protocol instance pointer. \r
- @param StartAddress The start address of the memory range. \r
- @param Length The memory range's length. \r
+ @param This The protocol instance pointer. \r
+ @param StartAddress The start address of the compatible memory range that\r
+ must be below 16M.\r
+ @param Length The compatible memory range's length. \r
\r
@retval EFI_SUCCESS The compatible memory range pass the memory test. \r
- @retval EFI_INVALID_PARAMETER The compatible memory range must be below 16M.\r
+ @retval EFI_INVALID_PARAMETER The compatible memory range are not below Low 16M.\r
\r
**/\r
typedef\r
EFI_STATUS\r
-(EFIAPI *EFI_MEMORY_TEST_COMPATIBLE_RANGE) (\r
+(EFIAPI *EFI_MEMORY_TEST_COMPATIBLE_RANGE)(\r
IN EFI_GENERIC_MEMORY_TEST_PROTOCOL *This,\r
IN EFI_PHYSICAL_ADDRESS StartAddress,\r
IN UINT64 Length\r
- )\r
-;\r
+ );\r
\r
struct _EFI_GENERIC_MEMORY_TEST_PROTOCOL {\r
EFI_MEMORY_TEST_INIT MemoryTestInit;\r