2 This protocol defines the generic memory test interfaces in Dxe phase.
4 Copyright (c) 2006 - 2008, Intel Corporation. <BR>
5 All rights reserved. This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
15 #ifndef __GENERIC_MEMORY_TEST_H__
16 #define __GENERIC_MEMORY_TEST_H__
18 #define EFI_GENERIC_MEMORY_TEST_PROTOCOL_GUID \
19 { 0x309de7f1, 0x7f5e, 0x4ace, {0xb4, 0x9c, 0x53, 0x1b, 0xe5, 0xaa, 0x95, 0xef} }
21 typedef struct _EFI_GENERIC_MEMORY_TEST_PROTOCOL EFI_GENERIC_MEMORY_TEST_PROTOCOL
;
24 /// Memory test coverage level
25 /// Ignore chooses not to test memory, Quick and Sparse test some memory, and Extensive performs a detailed memory test.
33 } EXTENDMEM_COVERAGE_LEVEL
;
37 Initialize the generic memory test.
39 @param This Protocol instance pointer.
40 @param Level The coverage level of the memory test.
41 @param RequireSoftECCInit Indicate if the memory need software ECC init.
43 @retval EFI_SUCCESS The generic memory test is initialized correctly.
44 @retval EFI_NO_MEDIA The system had no memory to be tested.
49 (EFIAPI
*EFI_MEMORY_TEST_INIT
)(
50 IN EFI_GENERIC_MEMORY_TEST_PROTOCOL
*This
,
51 IN EXTENDMEM_COVERAGE_LEVEL Level
,
52 OUT BOOLEAN
*RequireSoftECCInit
57 Perform the memory test.
59 @param This Protocol instance pointer.
60 @param TestedMemorySize Return the tested extended memory size.
61 @param TotalMemorySize Return the whole system physical memory size.
62 The total memory size does not include memory in a slot with a disabled DIMM.
63 @param ErrorOut TRUE if the memory error occured.
64 @param IfTestAbort Indicates that the user pressed "ESC" to skip the memory test.
66 @retval EFI_SUCCESS One block of memory passed the test.
67 @retval EFI_NOT_FOUND All memory blocks have already been tested.
68 @retval EFI_DEVICE_ERROR Memory device error occured, and no agent can handle it.
73 (EFIAPI
*EFI_PERFORM_MEMORY_TEST
)(
74 IN EFI_GENERIC_MEMORY_TEST_PROTOCOL
*This
,
75 OUT UINT64
*TestedMemorySize
,
76 OUT UINT64
*TotalMemorySize
,
77 OUT BOOLEAN
*ErrorOut
,
78 IN BOOLEAN IfTestAbort
83 Finish the memory test.
85 @param This Protocol instance pointer.
87 @retval EFI_SUCCESS Success. All resources used in the memory test are freed.
92 (EFIAPI
*EFI_MEMORY_TEST_FINISHED
)(
93 IN EFI_GENERIC_MEMORY_TEST_PROTOCOL
*This
97 Provides the capability to test the compatible range used by a special
100 @param This Protocol instance pointer.
101 @param StartAddress The start address of the compatible memory range that
103 @param Length The compatible memory range's length.
105 @retval EFI_SUCCESS The compatible memory range pass the memory test.
106 @retval EFI_INVALID_PARAMETER The compatible memory range are not below Low 16M.
111 (EFIAPI
*EFI_MEMORY_TEST_COMPATIBLE_RANGE
)(
112 IN EFI_GENERIC_MEMORY_TEST_PROTOCOL
*This
,
113 IN EFI_PHYSICAL_ADDRESS StartAddress
,
117 struct _EFI_GENERIC_MEMORY_TEST_PROTOCOL
{
118 EFI_MEMORY_TEST_INIT MemoryTestInit
;
119 EFI_PERFORM_MEMORY_TEST PerformMemoryTest
;
120 EFI_MEMORY_TEST_FINISHED Finished
;
121 EFI_MEMORY_TEST_COMPATIBLE_RANGE CompatibleRangeTest
;
124 extern EFI_GUID gEfiGenericMemTestProtocolGuid
;