QuarkPlatformPkg/Pci/Dxe/PciHostBridge/PciHostBridge.h - third_party/edk2 - Git at Google

 /** @file
 The Header file of the Pci Host Bridge Driver.

 Copyright (c) 2013-2015 Intel Corporation.

 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
 http://opensource.org/licenses/bsd-license.php

 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.


 **/

 #ifndef _PCI_HOST_BRIDGE_H_
 #define _PCI_HOST_BRIDGE_H_


 #include <PiDxe.h>
 #include <IndustryStandard/Acpi.h>
 #include <IndustryStandard/Pci.h>
 #include <PciRootBridge.h>
 #include <Library/UefiDriverEntryPoint.h>
 #include <IndustryStandard/Pci22.h>
 #include <Library/UefiLib.h>
 #include <Guid/HobList.h>
 #include <Library/UefiRuntimeServicesTableLib.h>
 #include <Protocol/PciHostBridgeResourceAllocation.h>

 #define PCI_HOST_BRIDGE_SIGNATURE SIGNATURE_32 ('e', 'h', 's', 't')
 typedef struct {
   UINTN                                             Signature;
   EFI_HANDLE                                        HostBridgeHandle;
   UINTN                                             RootBridgeCount;
   EFI_LIST_ENTRY                                    Head;
   BOOLEAN                                           ResourceSubmited;
   BOOLEAN                                           CanRestarted;
   EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL  ResAlloc;
 } PCI_HOST_BRIDGE_INSTANCE;

 #define INSTANCE_FROM_RESOURCE_ALLOCATION_THIS(a) CR (a, PCI_HOST_BRIDGE_INSTANCE, ResAlloc, PCI_HOST_BRIDGE_SIGNATURE)

 typedef enum {
   SocketResourceRatioChanged,
   SocketResourceRatioNotChanged,
   SocketResourceAdjustMax
 } SOCKET_RESOURCE_ADJUSTMENT_RESULT;

 //
 // Driver Entry Point
 //
 EFI_STATUS
 EFIAPI
 InitializePciHostBridge (
   IN EFI_HANDLE         ImageHandle,
   IN EFI_SYSTEM_TABLE   *SystemTable
   )
 /*++

 Routine Description:

   Entry point of this driver.

 Arguments:

   ImageHandle  -  Image handle of this driver.
   SystemTable  -  Pointer to standard EFI system table.

 Returns:

   EFI_SUCCESS       -  Succeed.
   EFI_DEVICE_ERROR  -  Fail to install PCI_ROOT_BRIDGE_IO protocol.

 --*/
 ;

 //
 //  HostBridge Resource Allocation interface
 //
 EFI_STATUS
 EFIAPI
 NotifyPhase (
   IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL   *This,
   IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE      Phase
   )
 /*++

 Routine Description:

   Enter a certain phase of the PCI enumeration process.

 Arguments:

   This   -  The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL instance.
   Phase  -  The phase during enumeration.

 Returns:

   EFI_SUCCESS            -  Succeed.
   EFI_INVALID_PARAMETER  -  Wrong phase parameter passed in.
   EFI_NOT_READY          -  Resources have not been submitted yet.

 --*/
 ;

 EFI_STATUS
 EFIAPI
 GetNextRootBridge (
   IN     EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
   IN OUT EFI_HANDLE                                       *RootBridgeHandle
   )
 /*++

 Routine Description:

   Return the device handle of the next PCI root bridge that is associated with
   this Host Bridge.

 Arguments:

   This              - The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
   RootBridgeHandle  -  Returns the device handle of the next PCI Root Bridge.
                        On input, it holds the RootBridgeHandle returned by the most
                        recent call to GetNextRootBridge().The handle for the first
                        PCI Root Bridge is returned if RootBridgeHandle is NULL on input.

 Returns:

   EFI_SUCCESS            -  Succeed.
   EFI_NOT_FOUND          -  Next PCI root bridge not found.
   EFI_INVALID_PARAMETER  -  Wrong parameter passed in.

 --*/
 ;

 EFI_STATUS
 EFIAPI
 GetAttributes (
   IN  EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
   IN  EFI_HANDLE                                       RootBridgeHandle,
   OUT UINT64                                           *Attributes
   )
 /*++

 Routine Description:

   Returns the attributes of a PCI Root Bridge.

 Arguments:

   This              -  The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance
   RootBridgeHandle  -  The device handle of the PCI Root Bridge
                        that the caller is interested in
   Attributes        -  The pointer to attributes of the PCI Root Bridge

 Returns:

   EFI_SUCCESS            -  Succeed.
   EFI_INVALID_PARAMETER  -  Attributes parameter passed in is NULL or
                             RootBridgeHandle is not an EFI_HANDLE
                             that was returned on a previous call to
                             GetNextRootBridge().

 --*/
 ;

 EFI_STATUS
 EFIAPI
 StartBusEnumeration (
   IN  EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
   IN  EFI_HANDLE                                       RootBridgeHandle,
   OUT VOID                                             **Configuration
   )
 /*++

 Routine Description:

   This is the request from the PCI enumerator to set up
   the specified PCI Root Bridge for bus enumeration process.

 Arguments:

   This              -  The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
   RootBridgeHandle  -  The PCI Root Bridge to be set up.
   Configuration     -  Pointer to the pointer to the PCI bus resource descriptor.

 Returns:

   EFI_SUCCESS            -  Succeed.
   EFI_OUT_OF_RESOURCES   -  Not enough pool to be allocated.
   EFI_INVALID_PARAMETER  -  RootBridgeHandle is not a valid handle.

 --*/
 ;

 EFI_STATUS
 EFIAPI
 SetBusNumbers (
   IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
   IN EFI_HANDLE                                       RootBridgeHandle,
   IN VOID                                             *Configuration
   )
 /*++

 Routine Description:

   This function programs the PCI Root Bridge hardware so that
   it decodes the specified PCI bus range.

 Arguments:

   This              -  The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
   RootBridgeHandle  -  The PCI Root Bridge whose bus range is to be programmed.
   Configuration     -  The pointer to the PCI bus resource descriptor.

 Returns:

   EFI_SUCCESS            -  Succeed.
   EFI_INVALID_PARAMETER  -  Wrong parameters passed in.

 --*/
 ;

 EFI_STATUS
 EFIAPI
 SubmitResources (
   IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
   IN EFI_HANDLE                                       RootBridgeHandle,
   IN VOID                                             *Configuration
   )
 /*++

 Routine Description:

   Submits the I/O and memory resource requirements for the specified PCI Root Bridge.

 Arguments:

   This              -  The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance
   RootBridgeHandle  -  The PCI Root Bridge whose I/O and memory resource requirements
                        are being submitted
   Configuration     -  The pointer to the PCI I/O and PCI memory resource descriptor

 Returns:

   EFI_SUCCESS            -  Succeed.
   EFI_INVALID_PARAMETER  -  Wrong parameters passed in.

 --*/
 ;

 EFI_STATUS
 EFIAPI
 GetProposedResources (
   IN  EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
   IN  EFI_HANDLE                                       RootBridgeHandle,
   OUT VOID                                             **Configuration
   )
 /*++

 Routine Description:

   This function returns the proposed resource settings for the specified
   PCI Root Bridge.

 Arguments:

   This              -  The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
   RootBridgeHandle  -  The PCI Root Bridge handle.
   Configuration     -  The pointer to the pointer to the PCI I/O
                        and memory resource descriptor.

 Returns:

   EFI_SUCCESS            -  Succeed.
   EFI_OUT_OF_RESOURCES   -  Not enough pool to be allocated.
   EFI_INVALID_PARAMETER  -  RootBridgeHandle is not a valid handle.

 --*/
 ;

 EFI_STATUS
 EFIAPI
 PreprocessController (
   IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL          *This,
   IN EFI_HANDLE                                                RootBridgeHandle,
   IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_PCI_ADDRESS               PciAddress,
   IN EFI_PCI_CONTROLLER_RESOURCE_ALLOCATION_PHASE              Phase
   )
 /*++

 Routine Description:

   This function is called for all the PCI controllers that the PCI
   bus driver finds. Can be used to Preprogram the controller.

 Arguments:

   This              -  The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
   RootBridgeHandle  -  The PCI Root Bridge handle.
   PciAddress        -  Address of the controller on the PCI bus.
   Phase             -  The Phase during resource allocation.

 Returns:

   EFI_SUCCESS            -  Succeed.
   EFI_INVALID_PARAMETER  -  RootBridgeHandle is not a valid handle.

 --*/
 ;

 //
 // Host Bridge Silicon specific hooks
 //
 UINT64
 GetAllocAttributes (
   IN  UINTN        RootBridgeIndex
   )
 /*++

 Routine Description:

   Returns the Allocation attributes for the BNB Root Bridge.

 Arguments:

   RootBridgeIndex  -  The root bridge number. 0 based.

 Returns:

   EFI_PCI_HOST_BRIDGE_COMBINE_MEM_PMEM | EFI_PCI_HOST_BRIDGE_MEM64_DECODE

 --*/
 ;

 EFI_STATUS
 GetHostBridgeMemApertures (
   IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL               *PciRootBridgeIo,
   OUT UINT32                                        *Mem32Base,
   OUT UINT32                                        *Mem32Limit,
   OUT UINT64                                        *Mem64Base,
   OUT UINT64                                        *Mem64Limit
   )
 /*++

 Routine Description:

   Returns memory apertures for the BNB Root Bridge.

 Arguments:

   PciRootBridgeIo  -  Pointer to Efi Pci root bridge Io protocol interface instance.
   Mem32Base        -  Pointer to 32 bit memory base. This is the lowest 32 bit memory address
                       that is decoded by the Host Bridge.
   Mem32Limit       -  Pointer to 32 bit memory limit.This is the highest 32 bit memory address
                       that is decoded by the Host Bridge. The size of the 32 bit window is
                       (Mem32Limit - Mem32base + 1).
   Mem64Base        -  Pointer to 64 bit memory base. This is the lowest 64 bit memory address
                       that is decoded by the Host Bridge.
   Mem64Limit       -  Pointer to 64 bit memory limit.This is the highest 64 bit memory address
                       that is decoded by the Host Bridge. The size of the 64 bit window is
                       (Mem64Limit - Mem64base + 1). Set Mem64Limit < Mem64Base if the host bridge
                       does not support 64 bit memory addresses.

 Returns:

   EFI_SUCCESS  -  Success.

 --*/
 ;

 UINT64
 Power2MaxMemory (
   IN UINT64         MemoryLength
   )
 /*++

 Routine Description:

   Calculate maximum memory length that can be fit to a mtrr.

 Arguments:

   MemoryLength  -  Input memory length.

 Returns:

   Returned Maximum length.

 --*/
 ;

 #endif
	/** @file
	The Header file of the Pci Host Bridge Driver.

	Copyright (c) 2013-2015 Intel Corporation.

	This program and the accompanying materials
	are licensed and made available under the terms and conditions of the BSD License
	which accompanies this distribution. The full text of the license may be found at
	http://opensource.org/licenses/bsd-license.php

	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.


	**/

	#ifndef _PCI_HOST_BRIDGE_H_
	#define _PCI_HOST_BRIDGE_H_


	#include <PiDxe.h>
	#include <IndustryStandard/Acpi.h>
	#include <IndustryStandard/Pci.h>
	#include <PciRootBridge.h>
	#include <Library/UefiDriverEntryPoint.h>
	#include <IndustryStandard/Pci22.h>
	#include <Library/UefiLib.h>
	#include <Guid/HobList.h>
	#include <Library/UefiRuntimeServicesTableLib.h>
	#include <Protocol/PciHostBridgeResourceAllocation.h>

	#define PCI_HOST_BRIDGE_SIGNATURE SIGNATURE_32 ('e', 'h', 's', 't')
	typedef struct {
	UINTN Signature;
	EFI_HANDLE HostBridgeHandle;
	UINTN RootBridgeCount;
	EFI_LIST_ENTRY Head;
	BOOLEAN ResourceSubmited;
	BOOLEAN CanRestarted;
	EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL ResAlloc;
	} PCI_HOST_BRIDGE_INSTANCE;

	#define INSTANCE_FROM_RESOURCE_ALLOCATION_THIS(a) CR (a, PCI_HOST_BRIDGE_INSTANCE, ResAlloc, PCI_HOST_BRIDGE_SIGNATURE)

	typedef enum {
	SocketResourceRatioChanged,
	SocketResourceRatioNotChanged,
	SocketResourceAdjustMax
	} SOCKET_RESOURCE_ADJUSTMENT_RESULT;

	//
	// Driver Entry Point
	//
	EFI_STATUS
	EFIAPI
	InitializePciHostBridge (
	IN EFI_HANDLE ImageHandle,
	IN EFI_SYSTEM_TABLE *SystemTable
	)
	/*++

	Routine Description:

	Entry point of this driver.

	Arguments:

	ImageHandle - Image handle of this driver.
	SystemTable - Pointer to standard EFI system table.

	Returns:

	EFI_SUCCESS - Succeed.
	EFI_DEVICE_ERROR - Fail to install PCI_ROOT_BRIDGE_IO protocol.

	--*/
	;

	//
	// HostBridge Resource Allocation interface
	//
	EFI_STATUS
	EFIAPI
	NotifyPhase (
	IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
	IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE Phase
	)
	/*++

	Routine Description:

	Enter a certain phase of the PCI enumeration process.

	Arguments:

	This - The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL instance.
	Phase - The phase during enumeration.

	Returns:

	EFI_SUCCESS - Succeed.
	EFI_INVALID_PARAMETER - Wrong phase parameter passed in.
	EFI_NOT_READY - Resources have not been submitted yet.

	--*/
	;

	EFI_STATUS
	EFIAPI
	GetNextRootBridge (
	IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
	IN OUT EFI_HANDLE *RootBridgeHandle
	)
	/*++

	Routine Description:

	Return the device handle of the next PCI root bridge that is associated with
	this Host Bridge.

	Arguments:

	This - The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
	RootBridgeHandle - Returns the device handle of the next PCI Root Bridge.
	On input, it holds the RootBridgeHandle returned by the most
	recent call to GetNextRootBridge().The handle for the first
	PCI Root Bridge is returned if RootBridgeHandle is NULL on input.

	Returns:

	EFI_SUCCESS - Succeed.
	EFI_NOT_FOUND - Next PCI root bridge not found.
	EFI_INVALID_PARAMETER - Wrong parameter passed in.

	--*/
	;

	EFI_STATUS
	EFIAPI
	GetAttributes (
	IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
	IN EFI_HANDLE RootBridgeHandle,
	OUT UINT64 *Attributes
	)
	/*++

	Routine Description:

	Returns the attributes of a PCI Root Bridge.

	Arguments:

	This - The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance
	RootBridgeHandle - The device handle of the PCI Root Bridge
	that the caller is interested in
	Attributes - The pointer to attributes of the PCI Root Bridge

	Returns:

	EFI_SUCCESS - Succeed.
	EFI_INVALID_PARAMETER - Attributes parameter passed in is NULL or
	RootBridgeHandle is not an EFI_HANDLE
	that was returned on a previous call to
	GetNextRootBridge().

	--*/
	;

	EFI_STATUS
	EFIAPI
	StartBusEnumeration (
	IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
	IN EFI_HANDLE RootBridgeHandle,
	OUT VOID **Configuration
	)
	/*++

	Routine Description:

	This is the request from the PCI enumerator to set up
	the specified PCI Root Bridge for bus enumeration process.

	Arguments:

	This - The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
	RootBridgeHandle - The PCI Root Bridge to be set up.
	Configuration - Pointer to the pointer to the PCI bus resource descriptor.

	Returns:

	EFI_SUCCESS - Succeed.
	EFI_OUT_OF_RESOURCES - Not enough pool to be allocated.
	EFI_INVALID_PARAMETER - RootBridgeHandle is not a valid handle.

	--*/
	;

	EFI_STATUS
	EFIAPI
	SetBusNumbers (
	IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
	IN EFI_HANDLE RootBridgeHandle,
	IN VOID *Configuration
	)
	/*++

	Routine Description:

	This function programs the PCI Root Bridge hardware so that
	it decodes the specified PCI bus range.

	Arguments:

	This - The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
	RootBridgeHandle - The PCI Root Bridge whose bus range is to be programmed.
	Configuration - The pointer to the PCI bus resource descriptor.

	Returns:

	EFI_SUCCESS - Succeed.
	EFI_INVALID_PARAMETER - Wrong parameters passed in.

	--*/
	;

	EFI_STATUS
	EFIAPI
	SubmitResources (
	IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
	IN EFI_HANDLE RootBridgeHandle,
	IN VOID *Configuration
	)
	/*++

	Routine Description:

	Submits the I/O and memory resource requirements for the specified PCI Root Bridge.

	Arguments:

	This - The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance
	RootBridgeHandle - The PCI Root Bridge whose I/O and memory resource requirements
	are being submitted
	Configuration - The pointer to the PCI I/O and PCI memory resource descriptor

	Returns:

	EFI_SUCCESS - Succeed.
	EFI_INVALID_PARAMETER - Wrong parameters passed in.

	--*/
	;

	EFI_STATUS
	EFIAPI
	GetProposedResources (
	IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
	IN EFI_HANDLE RootBridgeHandle,
	OUT VOID **Configuration
	)
	/*++

	Routine Description:

	This function returns the proposed resource settings for the specified
	PCI Root Bridge.

	Arguments:

	This - The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
	RootBridgeHandle - The PCI Root Bridge handle.
	Configuration - The pointer to the pointer to the PCI I/O
	and memory resource descriptor.

	Returns:

	EFI_SUCCESS - Succeed.
	EFI_OUT_OF_RESOURCES - Not enough pool to be allocated.
	EFI_INVALID_PARAMETER - RootBridgeHandle is not a valid handle.

	--*/
	;

	EFI_STATUS
	EFIAPI
	PreprocessController (
	IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
	IN EFI_HANDLE RootBridgeHandle,
	IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_PCI_ADDRESS PciAddress,
	IN EFI_PCI_CONTROLLER_RESOURCE_ALLOCATION_PHASE Phase
	)
	/*++

	Routine Description:

	This function is called for all the PCI controllers that the PCI
	bus driver finds. Can be used to Preprogram the controller.

	Arguments:

	This - The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
	RootBridgeHandle - The PCI Root Bridge handle.
	PciAddress - Address of the controller on the PCI bus.
	Phase - The Phase during resource allocation.

	Returns:

	EFI_SUCCESS - Succeed.
	EFI_INVALID_PARAMETER - RootBridgeHandle is not a valid handle.

	--*/
	;

	//
	// Host Bridge Silicon specific hooks
	//
	UINT64
	GetAllocAttributes (
	IN UINTN RootBridgeIndex
	)
	/*++

	Routine Description:

	Returns the Allocation attributes for the BNB Root Bridge.

	Arguments:

	RootBridgeIndex - The root bridge number. 0 based.

	Returns:

	EFI_PCI_HOST_BRIDGE_COMBINE_MEM_PMEM \| EFI_PCI_HOST_BRIDGE_MEM64_DECODE

	--*/
	;

	EFI_STATUS
	GetHostBridgeMemApertures (
	IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *PciRootBridgeIo,
	OUT UINT32 *Mem32Base,
	OUT UINT32 *Mem32Limit,
	OUT UINT64 *Mem64Base,
	OUT UINT64 *Mem64Limit
	)
	/*++

	Routine Description:

	Returns memory apertures for the BNB Root Bridge.

	Arguments:

	PciRootBridgeIo - Pointer to Efi Pci root bridge Io protocol interface instance.
	Mem32Base - Pointer to 32 bit memory base. This is the lowest 32 bit memory address
	that is decoded by the Host Bridge.
	Mem32Limit - Pointer to 32 bit memory limit.This is the highest 32 bit memory address
	that is decoded by the Host Bridge. The size of the 32 bit window is
	(Mem32Limit - Mem32base + 1).
	Mem64Base - Pointer to 64 bit memory base. This is the lowest 64 bit memory address
	that is decoded by the Host Bridge.
	Mem64Limit - Pointer to 64 bit memory limit.This is the highest 64 bit memory address
	that is decoded by the Host Bridge. The size of the 64 bit window is
	(Mem64Limit - Mem64base + 1). Set Mem64Limit < Mem64Base if the host bridge
	does not support 64 bit memory addresses.

	Returns:

	EFI_SUCCESS - Success.

	--*/
	;

	UINT64
	Power2MaxMemory (
	IN UINT64 MemoryLength
	)
	/*++

	Routine Description:

	Calculate maximum memory length that can be fit to a mtrr.

	Arguments:

	MemoryLength - Input memory length.

	Returns:

	Returned Maximum length.

	--*/
	;

	#endif