-/*++\r
-\r
-Copyright (c) 2006, Intel Corporation \r
-All rights reserved. This program and the accompanying materials \r
-are licensed and made available under the terms and conditions of the BSD License \r
-which accompanies this distribution. The full text of the license may be found at \r
-http://opensource.org/licenses/bsd-license.php \r
- \r
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
-\r
-Module Name:\r
+/** @file\r
+ This protocol defines the generic memory test interfaces in Dxe phase.\r
\r
- GenericMemoryTest.h\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
-Abstract:\r
-\r
- The EFI generic memory test protocol\r
- For more information please look at EfiMemoryTest.doc\r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
---*/\r
+**/\r
\r
#ifndef __GENERIC_MEMORY_TEST_H__\r
#define __GENERIC_MEMORY_TEST_H__\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
MAXLEVEL\r
} EXTENDMEM_COVERAGE_LEVEL;\r
\r
+\r
+/**\r
+ Initialize the generic memory test.\r
+\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 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
- IN EFI_GENERIC_MEMORY_TEST_PROTOCOL *This,\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
- Routine Description:\r
- Initialize the generic memory test.\r
\r
- Arguments:\r
- This - Protocol instance pointer.\r
- Level - The coverage level of the memory test.\r
- RequireSoftECCInit - Indicate if the memory need software ECC init.\r
+/**\r
+ Perform the memory test.\r
\r
- Returns:\r
- EFI_SUCCESS - The generic memory test initialized correctly.\r
- 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
+ @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. \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
---*/\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
- Routine Description:\r
- Perform the memory test.\r
-\r
- Arguments:\r
- This - Protocol instance pointer.\r
- TestedMemorySize - Return the tested extended memory size.\r
- 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
- ErrorOut - Any time the memory error occurs, this will be TRUE.\r
- IfTestAbort - Indicate if the user press "ESC" to skip the memory\r
- test.\r
-\r
- Returns:\r
- EFI_SUCCESS - One block of memory test ok, the block size is hide\r
- internally.\r
- EFI_NOT_FOUND - Indicate all the non-tested memory blocks have \r
- already go through.\r
-\r
---*/\r
-;\r
+ );\r
\r
+\r
+/**\r
+ Finish the memory test.\r
+\r
+ @param This The protocol instance pointer. \r
+\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
- Routine Description:\r
- The memory test finished.\r
+/**\r
+ Provides the capability to test the compatible range used by some special drivers.\r
\r
- Arguments:\r
- This - Protocol instance pointer.\r
-\r
- Returns:\r
- 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
-\r
---*/\r
-;\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 are not below Low 16M.\r
+\r
+**/\r
typedef\r
EFI_STATUS\r
-(EFIAPI *EFI_MEMORY_TEST_COMPATIBLE_RANGE) (\r
- IN EFI_GENERIC_MEMORY_TEST_PROTOCOL *This,\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
- Routine Description:\r
- Provide capability to test compatible range which used by some sepcial\r
- driver required using memory range before BDS perform memory test.\r
- \r
- Arguments:\r
- This - Protocol instance pointer.\r
- StartAddress - The start address of the memory range.\r
- Length - The memory range's length.\r
- \r
- Return:\r
- EFI_SUCCESS - The compatible memory range pass the memory test.\r
- EFI_DEVICE_ERROR - The compatible memory range test find memory error\r
- and also return return the error address.\r
- \r
---*/\r
-;\r
+ );\r
\r
struct _EFI_GENERIC_MEMORY_TEST_PROTOCOL {\r
EFI_MEMORY_TEST_INIT MemoryTestInit;\r