sravan/system76-edk2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Coding style modification.

Browse Source 
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@5058 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
klu2
2008-04-14 03:12:57 +00:00
parent e1a09a0eaa
commit bcd7041487
61 changed files with 3405 additions and 4718 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciCommand.c
View File

@ -22,7 +22,7 @@ PciOperateRegister (
IN UINT8 Operation,
OUT UINT16 *PtrCommand
)
/*++
/**
Routine Description:
@ -32,7 +32,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: Command - add argument and description to function comment
// TODO: Offset - add argument and description to function comment
@ -82,7 +82,7 @@ BOOLEAN
PciCapabilitySupport (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -92,7 +92,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
{
@ -110,7 +110,7 @@ LocateCapabilityRegBlock (
IN OUT UINT8 *Offset,
OUT UINT8 *NextRegBlock OPTIONAL
)
/*++
/**
Routine Description:
Locate cap reg.
@ -125,7 +125,7 @@ Returns:
None
--*/
**/
// TODO: EFI_UNSUPPORTED - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment
// TODO: EFI_NOT_FOUND - add return value to function comment

12
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciCommand.h
View File

@ -69,7 +69,7 @@ PciOperateRegister (
IN UINT8 Operation,
OUT UINT16 *PtrCommand
)
/*++
/**
Routine Description:
@ -87,14 +87,14 @@ Returns:
TODO: add return values
--*/
**/
;
BOOLEAN
PciCapabilitySupport (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -108,7 +108,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -118,7 +118,7 @@ LocateCapabilityRegBlock (
IN OUT UINT8 *Offset,
OUT UINT8 *NextRegBlock OPTIONAL
)
/*++
/**
Routine Description:
@ -135,7 +135,7 @@ Returns:
TODO: add return values
--*/
**/
;

76
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDeviceSupport.c
View File

@ -25,7 +25,7 @@ EFI_STATUS
InitializePciDevicePool (
VOID
)
/*++
/**
Routine Description:
@ -37,7 +37,7 @@ Returns:
None
--*/
**/
// TODO: EFI_SUCCESS - add return value to function comment
{
InitializeListHead (&gPciDevicePool);
@ -49,7 +49,7 @@ EFI_STATUS
InsertRootBridge (
PCI_IO_DEVICE *RootBridge
)
/*++
/**
Routine Description:
@ -63,7 +63,7 @@ Returns:
None
--*/
**/
// TODO: EFI_SUCCESS - add return value to function comment
{
@ -77,7 +77,7 @@ InsertPciDevice (
PCI_IO_DEVICE *Bridge,
PCI_IO_DEVICE *PciDeviceNode
)
/*++
/**
Routine Description:
@ -92,7 +92,7 @@ Returns:
None
--*/
**/
// TODO: EFI_SUCCESS - add return value to function comment
{
@ -106,7 +106,7 @@ EFI_STATUS
DestroyRootBridge (
IN PCI_IO_DEVICE *RootBridge
)
/*++
/**
Routine Description:
@ -119,7 +119,7 @@ Returns:
None
--*/
**/
// TODO: EFI_SUCCESS - add return value to function comment
{
DestroyPciDeviceTree (RootBridge);
@ -133,7 +133,7 @@ EFI_STATUS
FreePciDevice (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -148,7 +148,7 @@ Returns:
None
--*/
**/
// TODO: EFI_SUCCESS - add return value to function comment
{
@ -172,7 +172,7 @@ EFI_STATUS
DestroyPciDeviceTree (
IN PCI_IO_DEVICE *Bridge
)
/*++
/**
Routine Description:
@ -187,7 +187,7 @@ Returns:
None
--*/
**/
// TODO: EFI_SUCCESS - add return value to function comment
{
LIST_ENTRY *CurrentLink;
@ -218,7 +218,7 @@ EFI_STATUS
DestroyRootBridgeByHandle (
EFI_HANDLE Controller
)
/*++
/**
Routine Description:
@ -234,7 +234,7 @@ Returns:
None
--*/
**/
// TODO: EFI_SUCCESS - add return value to function comment
// TODO: EFI_NOT_FOUND - add return value to function comment
{
@ -270,7 +270,7 @@ RegisterPciDevice (
IN PCI_IO_DEVICE *PciIoDevice,
OUT EFI_HANDLE *Handle OPTIONAL
)
/*++
/**
Routine Description:
@ -289,7 +289,7 @@ Returns:
EFI_SUCCESS - The PCI device is successfully registered.
Others - An error occurred when registering the PCI device.
--*/
**/
{
EFI_STATUS Status;
VOID *PlatformOpRomBuffer;
@ -440,7 +440,7 @@ RemoveAllPciDeviceOnBridge (
EFI_HANDLE RootBridgeHandle,
PCI_IO_DEVICE *Bridge
)
/*++
/**
Routine Description:
@ -455,7 +455,7 @@ Returns:
None
--*/
**/
// TODO: EFI_SUCCESS - add return value to function comment
{
@ -495,7 +495,7 @@ DeRegisterPciDevice (
IN EFI_HANDLE Controller,
IN EFI_HANDLE Handle
)
/*++
/**
Routine Description:
@ -512,7 +512,7 @@ Returns:
None
--*/
**/
// TODO: EFI_SUCCESS - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -639,7 +639,7 @@ StartPciDevicesOnBridge (
IN OUT UINT8 *NumberOfChildren,
IN OUT EFI_HANDLE *ChildHandleBuffer
)
/*++
/**
Routine Description:
@ -657,7 +657,7 @@ Returns:
None
--*/
**/
// TODO: EFI_NOT_READY - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment
// TODO: EFI_UNSUPPORTED - add return value to function comment
@ -810,7 +810,7 @@ EFI_STATUS
StartPciDevices (
IN EFI_HANDLE Controller
)
/*++
/**
Routine Description:
@ -824,7 +824,7 @@ Returns:
None
--*/
**/
{
PCI_IO_DEVICE *RootBridge;
EFI_HANDLE ThisHostBridge;
@ -862,7 +862,7 @@ PCI_IO_DEVICE *
CreateRootBridge (
IN EFI_HANDLE RootBridgeHandle
)
/*++
/**
Routine Description:
@ -874,7 +874,7 @@ Returns:
None
--*/
**/
{
EFI_STATUS Status;
@ -956,7 +956,7 @@ PCI_IO_DEVICE *
GetRootBridgeByHandle (
EFI_HANDLE RootBridgeHandle
)
/*++
/**
Routine Description:
@ -969,7 +969,7 @@ Returns:
None
--*/
**/
{
PCI_IO_DEVICE *RootBridgeDev;
LIST_ENTRY *CurrentLink;
@ -994,7 +994,7 @@ PciDeviceExisted (
IN PCI_IO_DEVICE *Bridge,
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -1007,7 +1007,7 @@ Returns:
None
--*/
**/
{
PCI_IO_DEVICE *Temp;
@ -1039,7 +1039,7 @@ PCI_IO_DEVICE *
ActiveVGADeviceOnTheSameSegment (
IN PCI_IO_DEVICE *VgaDevice
)
/*++
/**
Routine Description:
@ -1051,7 +1051,7 @@ Returns:
None
--*/
**/
{
LIST_ENTRY *CurrentLink;
PCI_IO_DEVICE *Temp;
@ -1081,7 +1081,7 @@ PCI_IO_DEVICE *
ActiveVGADeviceOnTheRootBridge (
IN PCI_IO_DEVICE *RootBridge
)
/*++
/**
Routine Description:
@ -1093,7 +1093,7 @@ Returns:
None
--*/
**/
{
LIST_ENTRY *CurrentLink;
PCI_IO_DEVICE *Temp;
@ -1133,7 +1133,7 @@ GetHpcPciAddress (
IN EFI_DEVICE_PATH_PROTOCOL *HpcDevicePath,
OUT UINT64 *PciAddress
)
/*++
/**
Routine Description:
@ -1147,7 +1147,7 @@ Returns:
None
--*/
**/
// TODO: EFI_NOT_FOUND - add return value to function comment
// TODO: EFI_NOT_FOUND - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -1222,7 +1222,7 @@ GetHpcPciAddressFromRootBridge (
IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath,
OUT UINT64 *PciAddress
)
/*++
/**
Routine Description:
@ -1236,7 +1236,7 @@ Returns:
None
--*/
**/
// TODO: RootBridge - add argument and description to function comment
// TODO: RemainingDevicePath - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment

80
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDeviceSupport.h
View File

@ -18,7 +18,7 @@ EFI_STATUS
InitializePciDevicePool (
VOID
)
/*++
/**
Routine Description:
@ -32,14 +32,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
InsertRootBridge (
PCI_IO_DEVICE *RootBridge
)
/*++
/**
Routine Description:
@ -53,7 +53,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -61,7 +61,7 @@ InsertPciDevice (
PCI_IO_DEVICE *Bridge,
PCI_IO_DEVICE *PciDeviceNode
)
/*++
/**
Routine Description:
@ -76,14 +76,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
DestroyRootBridge (
IN PCI_IO_DEVICE *RootBridge
)
/*++
/**
Routine Description:
@ -97,14 +97,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
DestroyPciDeviceTree (
IN PCI_IO_DEVICE *Bridge
)
/*++
/**
Routine Description:
@ -118,14 +118,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
DestroyRootBridgeByHandle (
EFI_HANDLE Controller
)
/*++
/**
Routine Description:
@ -139,7 +139,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -148,7 +148,7 @@ RegisterPciDevice (
IN PCI_IO_DEVICE *PciIoDevice,
OUT EFI_HANDLE *Handle OPTIONAL
)
/*++
/**
Routine Description:
@ -164,7 +164,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -172,7 +172,7 @@ RemoveAllPciDeviceOnBridge (
EFI_HANDLE RootBridgeHandle,
PCI_IO_DEVICE *Bridge
)
/*++
/**
Routine Description:
@ -187,7 +187,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -195,7 +195,7 @@ DeRegisterPciDevice (
IN EFI_HANDLE Controller,
IN EFI_HANDLE Handle
)
/*++
/**
Routine Description:
@ -210,7 +210,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -221,7 +221,7 @@ StartPciDevicesOnBridge (
IN OUT UINT8 *NumberOfChildren,
IN OUT EFI_HANDLE *ChildHandleBuffer
)
/*++
/**
Routine Description:
@ -239,14 +239,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
StartPciDevices (
IN EFI_HANDLE Controller
)
/*++
/**
Routine Description:
@ -260,14 +260,14 @@ Returns:
TODO: add return values
--*/
**/
;
PCI_IO_DEVICE *
CreateRootBridge (
IN EFI_HANDLE RootBridgeHandle
)
/*++
/**
Routine Description:
@ -281,14 +281,14 @@ Returns:
TODO: add return values
--*/
**/
;
PCI_IO_DEVICE *
GetRootBridgeByHandle (
EFI_HANDLE RootBridgeHandle
)
/*++
/**
Routine Description:
@ -302,14 +302,14 @@ Returns:
TODO: add return values
--*/
**/
;
BOOLEAN
RootBridgeExisted (
IN EFI_HANDLE RootBridgeHandle
)
/*++
/**
Routine Description:
@ -323,7 +323,7 @@ Returns:
TODO: add return values
--*/
**/
;
BOOLEAN
@ -331,7 +331,7 @@ PciDeviceExisted (
IN PCI_IO_DEVICE *Bridge,
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -346,14 +346,14 @@ Returns:
TODO: add return values
--*/
**/
;
PCI_IO_DEVICE *
ActiveVGADeviceOnTheSameSegment (
IN PCI_IO_DEVICE *VgaDevice
)
/*++
/**
Routine Description:
@ -367,14 +367,14 @@ Returns:
TODO: add return values
--*/
**/
;
PCI_IO_DEVICE *
ActiveVGADeviceOnTheRootBridge (
IN PCI_IO_DEVICE *RootBridge
)
/*++
/**
Routine Description:
@ -388,7 +388,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -397,7 +397,7 @@ GetHpcPciAddress (
IN EFI_DEVICE_PATH_PROTOCOL *HpcDevicePath,
OUT UINT64 *PciAddress
)
/*++
/**
Routine Description:
@ -413,7 +413,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -422,7 +422,7 @@ GetHpcPciAddressFromRootBridge (
IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath,
OUT UINT64 *PciAddress
)
/*++
/**
Routine Description:
@ -438,14 +438,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
FreePciDevice (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -459,7 +459,7 @@ Returns:
TODO: add return values
--*/
**/
;
#endif

12
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDriverOverride.c
View File

@ -18,7 +18,7 @@ EFI_STATUS
InitializePciDriverOverrideInstance (
PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -30,7 +30,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
{
@ -44,7 +44,7 @@ GetDriver (
IN EFI_BUS_SPECIFIC_DRIVER_OVERRIDE_PROTOCOL *This,
IN OUT EFI_HANDLE *DriverImageHandle
)
/*++
/**
Routine Description:
@ -56,7 +56,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: DriverImageHandle - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -108,7 +108,7 @@ AddDriver (
IN PCI_IO_DEVICE *PciIoDevice,
IN EFI_HANDLE DriverImageHandle
)
/*++
/**
Routine Description:
@ -120,7 +120,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: DriverImageHandle - add argument and description to function comment
// TODO: EFI_OUT_OF_RESOURCES - add return value to function comment

12
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDriverOverride.h
View File

@ -32,7 +32,7 @@ EFI_STATUS
InitializePciDriverOverrideInstance (
PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -46,7 +46,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -54,7 +54,7 @@ AddDriver (
IN PCI_IO_DEVICE *PciIoDevice,
IN EFI_HANDLE DriverImageHandle
)
/*++
/**
Routine Description:
@ -69,7 +69,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -78,7 +78,7 @@ GetDriver (
IN EFI_BUS_SPECIFIC_DRIVER_OVERRIDE_PROTOCOL *This,
IN OUT EFI_HANDLE *DriverImageHandle
)
/*++
/**
Routine Description:
@ -93,7 +93,7 @@ Returns:
TODO: add return values
--*/
**/
;
#endif

92
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumerator.c
View File

@ -21,7 +21,7 @@ EFI_STATUS
PciEnumerator (
IN EFI_HANDLE Controller
)
/*++
/**
Routine Description:
@ -34,7 +34,7 @@ Returns:
None
--*/
**/
// TODO: Controller - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -139,7 +139,7 @@ PciRootBridgeEnumerator (
IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *PciResAlloc,
IN PCI_IO_DEVICE *RootBridgeDev
)
/*++
/**
Routine Description:
@ -149,7 +149,7 @@ Returns:
None
--*/
**/
// TODO: PciResAlloc - add argument and description to function comment
// TODO: RootBridgeDev - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -252,7 +252,7 @@ ProcessOptionRom (
IN UINT64 RomBase,
IN UINT64 MaxLength
)
/*++
/**
Routine Description:
@ -264,7 +264,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: RomBase - add argument and description to function comment
// TODO: MaxLength - add argument and description to function comment
@ -307,7 +307,7 @@ PciAssignBusNumber (
IN UINT8 StartBusNumber,
OUT UINT8 *SubBusNumber
)
/*++
/**
Routine Description:
@ -319,7 +319,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: StartBusNumber - add argument and description to function comment
// TODO: SubBusNumber - add argument and description to function comment
@ -456,7 +456,7 @@ DetermineRootBridgeAttributes (
IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *PciResAlloc,
IN PCI_IO_DEVICE *RootBridgeDev
)
/*++
/**
Routine Description:
@ -469,7 +469,7 @@ Returns:
None
--*/
**/
// TODO: PciResAlloc - add argument and description to function comment
// TODO: RootBridgeDev - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -518,7 +518,7 @@ UINT64
GetMaxOptionRomSize (
IN PCI_IO_DEVICE *Bridge
)
/*++
/**
Routine Description:
@ -530,7 +530,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
{
LIST_ENTRY *CurrentLink;
@ -586,7 +586,7 @@ EFI_STATUS
PciHostBridgeDeviceAttribute (
IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *PciResAlloc
)
/*++
/**
Routine Description:
@ -598,7 +598,7 @@ Returns:
None
--*/
**/
// TODO: PciResAlloc - add argument and description to function comment
// TODO: EFI_NOT_FOUND - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -642,7 +642,7 @@ GetResourceAllocationStatus (
OUT UINT64 *Mem64ResStatus,
OUT UINT64 *PMem64ResStatus
)
/*++
/**
Routine Description:
@ -654,7 +654,7 @@ Returns:
None
--*/
**/
// TODO: AcpiConfig - add argument and description to function comment
// TODO: IoResStatus - add argument and description to function comment
// TODO: Mem32ResStatus - add argument and description to function comment
@ -728,7 +728,7 @@ EFI_STATUS
RejectPciDevice (
IN PCI_IO_DEVICE *PciDevice
)
/*++
/**
Routine Description:
@ -740,7 +740,7 @@ Returns:
None
--*/
**/
// TODO: PciDevice - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
// TODO: EFI_ABORTED - add return value to function comment
@ -809,7 +809,7 @@ BOOLEAN
IsRejectiveDevice (
IN PCI_RESOURCE_NODE *PciResNode
)
/*++
/**
Routine Description:
@ -821,7 +821,7 @@ Returns:
None
--*/
**/
// TODO: PciResNode - add argument and description to function comment
{
PCI_IO_DEVICE *Temp;
@ -864,7 +864,7 @@ GetLargerConsumerDevice (
IN PCI_RESOURCE_NODE *PciResNode1,
IN PCI_RESOURCE_NODE *PciResNode2
)
/*++
/**
Routine Description:
@ -876,7 +876,7 @@ Returns:
None
--*/
**/
// TODO: PciResNode1 - add argument and description to function comment
// TODO: PciResNode2 - add argument and description to function comment
{
@ -906,7 +906,7 @@ PCI_RESOURCE_NODE *
GetMaxResourceConsumerDevice (
IN PCI_RESOURCE_NODE *ResPool
)
/*++
/**
Routine Description:
@ -918,7 +918,7 @@ Returns:
None
--*/
**/
// TODO: ResPool - add argument and description to function comment
{
PCI_RESOURCE_NODE *Temp;
@ -966,7 +966,7 @@ PciHostBridgeAdjustAllocation (
IN UINT64 Mem64ResStatus,
IN UINT64 PMem64ResStatus
)
/*++
/**
Routine Description:
@ -978,7 +978,7 @@ Returns:
None
--*/
**/
// TODO: IoPool - add argument and description to function comment
// TODO: Mem32Pool - add argument and description to function comment
// TODO: PMem32Pool - add argument and description to function comment
@ -1108,7 +1108,7 @@ ConstructAcpiResourceRequestor (
IN PCI_RESOURCE_NODE *PMem64Node,
OUT VOID **pConfig
)
/*++
/**
Routine Description:
@ -1118,7 +1118,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: IoNode - add argument and description to function comment
// TODO: Mem32Node - add argument and description to function comment
@ -1354,7 +1354,7 @@ GetResourceBase (
OUT UINT64 *Mem64Base,
OUT UINT64 *PMem64Base
)
/*++
/**
Routine Description:
@ -1364,7 +1364,7 @@ Returns:
None
--*/
**/
// TODO: pConfig - add argument and description to function comment
// TODO: IoBase - add argument and description to function comment
// TODO: Mem32Base - add argument and description to function comment
@ -1448,7 +1448,7 @@ EFI_STATUS
PciBridgeEnumerator (
IN PCI_IO_DEVICE *BridgeDev
)
/*++
/**
Routine Description:
@ -1458,7 +1458,7 @@ Returns:
None
--*/
**/
// TODO: BridgeDev - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
{
@ -1512,7 +1512,7 @@ EFI_STATUS
PciBridgeResourceAllocator (
IN PCI_IO_DEVICE *Bridge
)
/*++
/**
Routine Description:
@ -1522,7 +1522,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
{
@ -1676,7 +1676,7 @@ GetResourceBaseFromBridge (
OUT UINT64 *Mem64Base,
OUT UINT64 *PMem64Base
)
/*++
/**
Routine Description:
@ -1686,7 +1686,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: IoBase - add argument and description to function comment
// TODO: Mem32Base - add argument and description to function comment
@ -1766,7 +1766,7 @@ NotifyPhase (
IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *PciResAlloc,
EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE Phase
)
/*++
/**
Routine Description:
@ -1776,7 +1776,7 @@ Returns:
None
--*/
**/
// TODO: PciResAlloc - add argument and description to function comment
// TODO: Phase - add argument and description to function comment
// TODO: EFI_NOT_FOUND - add return value to function comment
@ -1850,7 +1850,7 @@ PreprocessController (
IN UINT8 Func,
IN EFI_PCI_CONTROLLER_RESOURCE_ALLOCATION_PHASE Phase
)
/*++
/**
Routine Description:
@ -1860,7 +1860,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: Bus - add argument and description to function comment
// TODO: Device - add argument and description to function comment
@ -1959,7 +1959,7 @@ PciHotPlugRequestNotify (
IN OUT UINT8 *NumberOfChildren,
IN OUT EFI_HANDLE * ChildHandleBuffer
)
/*++
/**
Routine Description:
@ -1978,7 +1978,7 @@ Returns:
Status code.
--*/
**/
// TODO: RemainingDevicePath - add argument and description to function comment
// TODO: EFI_NOT_FOUND - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -2078,7 +2078,7 @@ BOOLEAN
SearchHostBridgeHandle (
IN EFI_HANDLE RootBridgeHandle
)
/*++
/**
Routine Description:
@ -2088,7 +2088,7 @@ Returns:
None
--*/
**/
// TODO: RootBridgeHandle - add argument and description to function comment
{
EFI_HANDLE HostBridgeHandle;
@ -2126,7 +2126,7 @@ EFI_STATUS
AddHostBridgeEnumerator (
IN EFI_HANDLE HostBridgeHandle
)
/*++
/**
Routine Description:
@ -2136,7 +2136,7 @@ Returns:
None
--*/
**/
// TODO: HostBridgeHandle - add argument and description to function comment
// TODO: EFI_ABORTED - add return value to function comment
// TODO: EFI_ABORTED - add return value to function comment

96
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumerator.h
View File

@ -21,7 +21,7 @@ EFI_STATUS
PciEnumerator (
IN EFI_HANDLE Controller
)
/*++
/**
Routine Description:
@ -35,7 +35,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -43,7 +43,7 @@ PciRootBridgeEnumerator (
IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *PciResAlloc,
IN PCI_IO_DEVICE *RootBridgeDev
)
/*++
/**
Routine Description:
@ -58,7 +58,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -67,7 +67,7 @@ ProcessOptionRom (
IN UINT64 RomBase,
IN UINT64 MaxLength
)
/*++
/**
Routine Description:
@ -83,7 +83,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -92,7 +92,7 @@ PciAssignBusNumber (
IN UINT8 StartBusNumber,
OUT UINT8 *SubBusNumber
)
/*++
/**
Routine Description:
@ -108,7 +108,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -116,7 +116,7 @@ DetermineRootBridgeAttributes (
IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *PciResAlloc,
IN PCI_IO_DEVICE *RootBridgeDev
)
/*++
/**
Routine Description:
@ -131,14 +131,14 @@ Returns:
TODO: add return values
--*/
**/
;
UINT64
GetMaxOptionRomSize (
IN PCI_IO_DEVICE *Bridge
)
/*++
/**
Routine Description:
@ -152,14 +152,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
PciHostBridgeDeviceAttribute (
IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *PciResAlloc
)
/*++
/**
Routine Description:
@ -173,7 +173,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -185,7 +185,7 @@ GetResourceAllocationStatus (
OUT UINT64 *Mem64ResStatus,
OUT UINT64 *PMem64ResStatus
)
/*++
/**
Routine Description:
@ -204,14 +204,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
RejectPciDevice (
IN PCI_IO_DEVICE *PciDevice
)
/*++
/**
Routine Description:
@ -225,14 +225,14 @@ Returns:
TODO: add return values
--*/
**/
;
BOOLEAN
IsRejectiveDevice (
IN PCI_RESOURCE_NODE *PciResNode
)
/*++
/**
Routine Description:
@ -246,7 +246,7 @@ Returns:
TODO: add return values
--*/
**/
;
PCI_RESOURCE_NODE *
@ -254,7 +254,7 @@ GetLargerConsumerDevice (
IN PCI_RESOURCE_NODE *PciResNode1,
IN PCI_RESOURCE_NODE *PciResNode2
)
/*++
/**
Routine Description:
@ -269,14 +269,14 @@ Returns:
TODO: add return values
--*/
**/
;
PCI_RESOURCE_NODE *
GetMaxResourceConsumerDevice (
IN PCI_RESOURCE_NODE *ResPool
)
/*++
/**
Routine Description:
@ -290,7 +290,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -306,7 +306,7 @@ PciHostBridgeAdjustAllocation (
IN UINT64 Mem64ResStatus,
IN UINT64 PMem64ResStatus
)
/*++
/**
Routine Description:
@ -329,7 +329,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -342,7 +342,7 @@ ConstructAcpiResourceRequestor (
IN PCI_RESOURCE_NODE *PMem64Node,
OUT VOID **pConfig
)
/*++
/**
Routine Description:
@ -362,7 +362,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -374,7 +374,7 @@ GetResourceBase (
OUT UINT64 *Mem64Base,
OUT UINT64 *PMem64Base
)
/*++
/**
Routine Description:
@ -393,14 +393,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
PciBridgeEnumerator (
IN PCI_IO_DEVICE *BridgeDev
)
/*++
/**
Routine Description:
@ -414,14 +414,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
PciBridgeResourceAllocator (
IN PCI_IO_DEVICE *Bridge
)
/*++
/**
Routine Description:
@ -435,7 +435,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -447,7 +447,7 @@ GetResourceBaseFromBridge (
OUT UINT64 *Mem64Base,
OUT UINT64 *PMem64Base
)
/*++
/**
Routine Description:
@ -466,14 +466,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
PciHostBridgeP2CProcess (
IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *PciResAlloc
)
/*++
/**
Routine Description:
@ -487,7 +487,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -495,7 +495,7 @@ NotifyPhase (
IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *PciResAlloc,
EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE Phase
)
/*++
/**
Routine Description:
@ -510,7 +510,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -521,7 +521,7 @@ PreprocessController (
IN UINT8 Func,
IN EFI_PCI_CONTROLLER_RESOURCE_ALLOCATION_PHASE Phase
)
/*++
/**
Routine Description:
@ -539,7 +539,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -552,7 +552,7 @@ PciHotPlugRequestNotify (
IN OUT UINT8 *NumberOfChildren,
IN OUT EFI_HANDLE * ChildHandleBuffer
)
/*++
/**
Routine Description:
@ -571,14 +571,14 @@ Returns:
TODO: add return values
--*/
**/
;
BOOLEAN
SearchHostBridgeHandle (
IN EFI_HANDLE RootBridgeHandle
)
/*++
/**
Routine Description:
@ -592,14 +592,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
AddHostBridgeEnumerator (
IN EFI_HANDLE HostBridgeHandle
)
/*++
/**
Routine Description:
@ -613,7 +613,7 @@ Returns:
TODO: add return values
--*/
**/
;
#endif

104
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.c
View File

@ -25,7 +25,7 @@ PciDevicePresent (
UINT8 Device,
UINT8 Func
)
/*++
/**
Routine Description:
@ -37,7 +37,7 @@ Returns:
None
--*/
**/
// TODO: PciRootBridgeIo - add argument and description to function comment
// TODO: Pci - add argument and description to function comment
// TODO: Bus - add argument and description to function comment
@ -92,7 +92,7 @@ PciPciDeviceInfoCollector (
IN PCI_IO_DEVICE *Bridge,
UINT8 StartBusNumber
)
/*++
/**
Routine Description:
@ -102,7 +102,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: StartBusNumber - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -210,7 +210,7 @@ PciSearchDevice (
IN UINT8 Func,
OUT PCI_IO_DEVICE **PciDevice
)
/*++
/**
Routine Description:
@ -229,7 +229,7 @@ Returns:
Status code.
--*/
**/
// TODO: EFI_OUT_OF_RESOURCES - add return value to function comment
// TODO: EFI_OUT_OF_RESOURCES - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -339,7 +339,7 @@ GatherDeviceInfo (
UINT8 Device,
UINT8 Func
)
/*++
/**
Routine Description:
@ -349,7 +349,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: Pci - add argument and description to function comment
// TODO: Bus - add argument and description to function comment
@ -409,7 +409,7 @@ GatherPpbInfo (
UINT8 Device,
UINT8 Func
)
/*++
/**
Routine Description:
@ -419,7 +419,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: Pci - add argument and description to function comment
// TODO: Bus - add argument and description to function comment
@ -543,7 +543,7 @@ GatherP2CInfo (
UINT8 Device,
UINT8 Func
)
/*++
/**
Routine Description:
@ -553,7 +553,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: Pci - add argument and description to function comment
// TODO: Bus - add argument and description to function comment
@ -614,7 +614,7 @@ CreatePciDevicePath (
IN EFI_DEVICE_PATH_PROTOCOL *ParentDevicePath,
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -624,7 +624,7 @@ Returns:
None
--*/
**/
// TODO: ParentDevicePath - add argument and description to function comment
// TODO: PciIoDevice - add argument and description to function comment
{
@ -652,7 +652,7 @@ BarExisted (
OUT UINT32 *BarLengthValue,
OUT UINT32 *OriginalBarValue
)
/*++
/**
Routine Description:
@ -670,7 +670,7 @@ Returns:
EFI_NOT_FOUND - The bar don't exist.
EFI_SUCCESS - The bar exist.
--*/
**/
{
EFI_PCI_IO_PROTOCOL *PciIo;
UINT32 OriginalValue;
@ -726,7 +726,7 @@ PciTestSupportedAttribute (
IN UINT16 *OldCommand,
IN UINT16 *OldBridgeControl
)
/*++
/**
Routine Description:
@ -736,7 +736,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: Command - add argument and description to function comment
// TODO: BridgeControl - add argument and description to function comment
@ -809,7 +809,7 @@ PciSetDeviceAttribute (
IN UINT16 BridgeControl,
IN UINTN Option
)
/*++
/**
Routine Description:
Set the supported or current attributes of a PCI device
@ -822,9 +822,9 @@ PciSetDeviceAttribute (
Returns:
--*/
**/
/*++
/**
Routine Description:
@ -838,7 +838,7 @@ Returns:
EFI_SUCCESS Always success
--*/
**/
{
UINT64 Attributes;
@ -925,7 +925,7 @@ GetFastBackToBackSupport (
IN PCI_IO_DEVICE *PciIoDevice,
IN UINT8 StatusIndex
)
/*++
/**
Routine Description:
@ -937,7 +937,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: StatusIndex - add argument and description to function comment
// TODO: EFI_UNSUPPORTED - add return value to function comment
@ -973,7 +973,7 @@ EFI_STATUS
ProcessOptionRomLight (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -986,7 +986,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
{
@ -1022,7 +1022,7 @@ EFI_STATUS
DetermineDeviceAttribute (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -1034,7 +1034,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
{
@ -1201,7 +1201,7 @@ EFI_STATUS
UpdatePciInfo (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -1213,7 +1213,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: EFI_UNSUPPORTED - add return value to function comment
{
@ -1359,7 +1359,7 @@ SetNewAlign (
IN UINT64 *Alignment,
IN UINT64 NewAlignment
)
/*++
/**
Routine Description:
@ -1371,7 +1371,7 @@ Returns:
None
--*/
**/
// TODO: Alignment - add argument and description to function comment
// TODO: NewAlignment - add argument and description to function comment
{
@ -1438,7 +1438,7 @@ PciParseBar (
IN UINTN Offset,
IN UINTN BarIndex
)
/*++
/**
Routine Description:
@ -1448,7 +1448,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: Offset - add argument and description to function comment
// TODO: BarIndex - add argument and description to function comment
@ -1628,7 +1628,7 @@ EFI_STATUS
InitializePciDevice (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -1641,7 +1641,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
{
@ -1666,7 +1666,7 @@ EFI_STATUS
InitializePpb (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -1676,7 +1676,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
{
@ -1719,7 +1719,7 @@ EFI_STATUS
InitializeP2C (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -1729,7 +1729,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
{
@ -1769,7 +1769,7 @@ CreatePciIoDevice (
UINT8 Device,
UINT8 Func
)
/*++
/**
Routine Description:
@ -1779,7 +1779,7 @@ Returns:
None
--*/
**/
// TODO: PciRootBridgeIo - add argument and description to function comment
// TODO: Pci - add argument and description to function comment
// TODO: Bus - add argument and description to function comment
@ -1862,7 +1862,7 @@ EFI_STATUS
PciEnumeratorLight (
IN EFI_HANDLE Controller
)
/*++
/**
Routine Description:
@ -1876,7 +1876,7 @@ Returns:
None
--*/
**/
// TODO: Controller - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -1985,7 +1985,7 @@ PciGetBusRange (
OUT UINT16 *MaxBus,
OUT UINT16 *BusRange
)
/*++
/**
Routine Description:
@ -2002,7 +2002,7 @@ Returns:
Status Code.
--*/
**/
// TODO: EFI_SUCCESS - add return value to function comment
// TODO: EFI_NOT_FOUND - add return value to function comment
{
@ -2034,7 +2034,7 @@ EFI_STATUS
StartManagingRootBridge (
IN PCI_IO_DEVICE *RootBridgeDev
)
/*++
/**
Routine Description:
@ -2045,7 +2045,7 @@ Returns:
None
--*/
**/
// TODO: RootBridgeDev - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
{
@ -2088,7 +2088,7 @@ BOOLEAN
IsPciDeviceRejected (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -2101,7 +2101,7 @@ Returns:
TRUE This device should be rejected
FALSE This device shouldn't be rejected
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
{
EFI_STATUS Status;
@ -2209,7 +2209,7 @@ ResetAllPpbBusNumber (
IN PCI_IO_DEVICE *Bridge,
IN UINT8 StartBusNumber
)
/*++
/**
Routine Description:
@ -2224,7 +2224,7 @@ Returns:
EFI_SUCCESS - TODO: Add description for return value
--*/
**/
{
EFI_STATUS Status;
PCI_TYPE00 Pci;

92
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.h
View File

@ -23,7 +23,7 @@ PciDevicePresent (
UINT8 Device,
UINT8 Func
)
/*++
/**
Routine Description:
@ -41,7 +41,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -49,7 +49,7 @@ PciPciDeviceInfoCollector (
IN PCI_IO_DEVICE *Bridge,
UINT8 StartBusNumber
)
/*++
/**
Routine Description:
@ -64,7 +64,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -76,7 +76,7 @@ PciSearchDevice (
UINT8 Func,
PCI_IO_DEVICE **PciDevice
)
/*++
/**
Routine Description:
@ -95,7 +95,7 @@ Returns:
TODO: add return values
--*/
**/
;
PCI_IO_DEVICE *
@ -106,7 +106,7 @@ GatherDeviceInfo (
UINT8 Device,
UINT8 Func
)
/*++
/**
Routine Description:
@ -124,7 +124,7 @@ Returns:
TODO: add return values
--*/
**/
;
PCI_IO_DEVICE *
@ -135,7 +135,7 @@ GatherPpbInfo (
UINT8 Device,
UINT8 Func
)
/*++
/**
Routine Description:
@ -153,7 +153,7 @@ Returns:
TODO: add return values
--*/
**/
;
PCI_IO_DEVICE *
@ -164,7 +164,7 @@ GatherP2CInfo (
UINT8 Device,
UINT8 Func
)
/*++
/**
Routine Description:
@ -182,7 +182,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_DEVICE_PATH_PROTOCOL *
@ -190,7 +190,7 @@ CreatePciDevicePath (
IN EFI_DEVICE_PATH_PROTOCOL *ParentDevicePath,
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -205,7 +205,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -215,7 +215,7 @@ BarExisted (
OUT UINT32 *BarLengthValue,
OUT UINT32 *OriginalBarValue
)
/*++
/**
Routine Description:
@ -232,7 +232,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -243,7 +243,7 @@ PciTestSupportedAttribute (
IN UINT16 *OldCommand,
IN UINT16 *OldBridgeControl
)
/*++
/**
Routine Description:
@ -261,7 +261,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -271,7 +271,7 @@ PciSetDeviceAttribute (
IN UINT16 BridgeControl,
IN UINTN Option
)
/*++
/**
Routine Description:
@ -288,7 +288,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -296,7 +296,7 @@ GetFastBackToBackSupport (
IN PCI_IO_DEVICE *PciIoDevice,
IN UINT8 StatusIndex
)
/*++
/**
Routine Description:
@ -311,14 +311,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
DetermineDeviceAttribute (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -332,14 +332,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
UpdatePciInfo (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -353,7 +353,7 @@ Returns:
TODO: add return values
--*/
**/
;
VOID
@ -361,7 +361,7 @@ SetNewAlign (
IN UINT64 *Alignment,
IN UINT64 NewAlignment
)
/*++
/**
Routine Description:
@ -376,7 +376,7 @@ Returns:
TODO: add return values
--*/
**/
;
UINTN
@ -385,7 +385,7 @@ PciParseBar (
IN UINTN Offset,
IN UINTN BarIndex
)
/*++
/**
Routine Description:
@ -401,14 +401,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
InitializePciDevice (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -422,14 +422,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
InitializePpb (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -443,14 +443,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
InitializeP2C (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -464,7 +464,7 @@ Returns:
TODO: add return values
--*/
**/
;
PCI_IO_DEVICE *
@ -475,7 +475,7 @@ CreatePciIoDevice (
UINT8 Device,
UINT8 Func
)
/*++
/**
Routine Description:
@ -493,14 +493,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
PciEnumeratorLight (
IN EFI_HANDLE Controller
)
/*++
/**
Routine Description:
@ -514,7 +514,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -524,7 +524,7 @@ PciGetBusRange (
OUT UINT16 *MaxBus,
OUT UINT16 *BusRange
)
/*++
/**
Routine Description:
@ -541,14 +541,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
StartManagingRootBridge (
IN PCI_IO_DEVICE *RootBridgeDev
)
/*++
/**
Routine Description:
@ -562,14 +562,14 @@ Returns:
TODO: add return values
--*/
**/
;
BOOLEAN
IsPciDeviceRejected (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -583,7 +583,7 @@ Returns:
TODO: add return values
--*/
**/
;
#endif

40
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciHotPlugSupport.c
View File

@ -26,7 +26,7 @@ PciHPCInitialized (
IN EFI_EVENT Event,
IN VOID *Context
)
/*++
/**
Routine Description:
@ -36,7 +36,7 @@ Returns:
None
--*/
**/
// TODO: Event - add argument and description to function comment
// TODO: Context - add argument and description to function comment
{
@ -52,7 +52,7 @@ EfiCompareDevicePath (
IN EFI_DEVICE_PATH_PROTOCOL *DevicePath1,
IN EFI_DEVICE_PATH_PROTOCOL *DevicePath2
)
/*++
/**
Routine Description:
@ -62,7 +62,7 @@ Returns:
None
--*/
**/
// TODO: DevicePath1 - add argument and description to function comment
// TODO: DevicePath2 - add argument and description to function comment
{
@ -87,7 +87,7 @@ EFI_STATUS
InitializeHotPlugSupport (
VOID
)
/*++
/**
Routine Description:
@ -97,7 +97,7 @@ Returns:
None
--*/
**/
// TODO: EFI_UNSUPPORTED - add return value to function comment
// TODO: EFI_OUT_OF_RESOURCES - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -153,7 +153,7 @@ IsRootPciHotPlugBus (
IN EFI_DEVICE_PATH_PROTOCOL *HpbDevicePath,
OUT UINTN *HpIndex
)
/*++
/**
Routine Description:
@ -166,7 +166,7 @@ Returns:
None
--*/
**/
// TODO: HpbDevicePath - add argument and description to function comment
{
UINTN Index;
@ -191,7 +191,7 @@ IsRootPciHotPlugController (
IN EFI_DEVICE_PATH_PROTOCOL *HpcDevicePath,
OUT UINTN *HpIndex
)
/*++
/**
Routine Description:
@ -204,7 +204,7 @@ Returns:
None
--*/
**/
{
UINTN Index;
@ -228,7 +228,7 @@ CreateEventForHpc (
IN UINTN HpIndex,
OUT EFI_EVENT *Event
)
/*++
/**
Routine Description:
@ -238,7 +238,7 @@ Returns:
None
--*/
**/
// TODO: HpIndex - add argument and description to function comment
// TODO: Event - add argument and description to function comment
{
@ -263,7 +263,7 @@ EFI_STATUS
AllRootHPCInitialized (
IN UINTN TimeoutInMicroSeconds
)
/*++
/**
Routine Description:
@ -274,7 +274,7 @@ Returns:
EFI_SUCCESS - All root hpc's initialization is finished before the timeout
EFI_TIMEOUT - Time out
--*/
**/
{
UINT32 Delay;
UINTN Index;
@ -309,7 +309,7 @@ EFI_STATUS
IsSHPC (
PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -319,7 +319,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: EFI_NOT_FOUND - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -356,7 +356,7 @@ EFI_STATUS
GetResourcePaddingForHpb (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -366,7 +366,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
// TODO: EFI_NOT_FOUND - add return value to function comment
@ -409,7 +409,7 @@ EFI_STATUS
IsPciHotPlugBus (
PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -419,7 +419,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment

40
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciHotPlugSupport.h
View File

@ -38,7 +38,7 @@ PciHPCInitialized (
IN EFI_EVENT Event,
IN VOID *Context
)
/*++
/**
Routine Description:
@ -53,7 +53,7 @@ Returns:
TODO: add return values
--*/
**/
;
BOOLEAN
@ -61,7 +61,7 @@ EfiCompareDevicePath (
IN EFI_DEVICE_PATH_PROTOCOL *DevicePath1,
IN EFI_DEVICE_PATH_PROTOCOL *DevicePath2
)
/*++
/**
Routine Description:
@ -76,14 +76,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
InitializeHotPlugSupport (
VOID
)
/*++
/**
Routine Description:
@ -97,14 +97,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
IsPciHotPlugBus (
PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -118,7 +118,7 @@ Returns:
TODO: add return values
--*/
**/
;
BOOLEAN
@ -126,7 +126,7 @@ IsRootPciHotPlugBus (
IN EFI_DEVICE_PATH_PROTOCOL *HpbDevicePath,
OUT UINTN *HpIndex
)
/*++
/**
Routine Description:
@ -141,7 +141,7 @@ Returns:
TODO: add return values
--*/
**/
;
BOOLEAN
@ -149,7 +149,7 @@ IsRootPciHotPlugController (
IN EFI_DEVICE_PATH_PROTOCOL *HpcDevicePath,
OUT UINTN *HpIndex
)
/*++
/**
Routine Description:
@ -164,7 +164,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -172,7 +172,7 @@ CreateEventForHpc (
IN UINTN HpIndex,
OUT EFI_EVENT *Event
)
/*++
/**
Routine Description:
@ -187,14 +187,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
AllRootHPCInitialized (
IN UINTN TimeoutInMicroSeconds
)
/*++
/**
Routine Description:
@ -207,14 +207,14 @@ Returns:
EFI_SUCCESS - All root hpc's initialization is finished before the timeout
EFI_TIMEOUT - Time out
--*/
**/
;
EFI_STATUS
IsSHPC (
PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -228,14 +228,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
GetResourcePaddingForHpb (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -249,7 +249,7 @@ Returns:
TODO: add return values
--*/
**/
;
#endif

108
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciIo.c
View File

@ -66,7 +66,7 @@ ReportErrorStatusCode (
IN PCI_IO_DEVICE *PciIoDevice,
IN EFI_STATUS_CODE_VALUE Code
)
/*++
/**
Routine Description:
@ -78,7 +78,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: Code - add argument and description to function comment
{
@ -93,7 +93,7 @@ EFI_STATUS
InitializePciIoInstance (
PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -105,7 +105,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
{
@ -122,7 +122,7 @@ PciIoVerifyBarAccess (
IN UINTN Count,
UINT64 *Offset
)
/*++
/**
Routine Description:
@ -134,7 +134,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: BarIndex - add argument and description to function comment
// TODO: Type - add argument and description to function comment
@ -193,7 +193,7 @@ PciIoVerifyConfigAccess (
IN UINTN Count,
IN UINT64 *Offset
)
/*++
/**
Routine Description:
@ -205,7 +205,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: Width - add argument and description to function comment
// TODO: Count - add argument and description to function comment
@ -258,7 +258,7 @@ PciIoPollMem (
IN UINT64 Delay,
OUT UINT64 *Result
)
/*++
/**
Routine Description:
@ -270,7 +270,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Width - add argument and description to function comment
// TODO: BarIndex - add argument and description to function comment
@ -330,7 +330,7 @@ PciIoPollIo (
IN UINT64 Delay,
OUT UINT64 *Result
)
/*++
/**
Routine Description:
@ -342,7 +342,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Width - add argument and description to function comment
// TODO: BarIndex - add argument and description to function comment
@ -396,7 +396,7 @@ PciIoMemRead (
IN UINTN Count,
IN OUT VOID *Buffer
)
/*++
/**
Routine Description:
@ -408,7 +408,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Width - add argument and description to function comment
// TODO: BarIndex - add argument and description to function comment
@ -457,7 +457,7 @@ PciIoMemWrite (
IN UINTN Count,
IN OUT VOID *Buffer
)
/*++
/**
Routine Description:
@ -469,7 +469,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Width - add argument and description to function comment
// TODO: BarIndex - add argument and description to function comment
@ -518,7 +518,7 @@ PciIoIoRead (
IN UINTN Count,
IN OUT VOID *Buffer
)
/*++
/**
Routine Description:
@ -530,7 +530,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Width - add argument and description to function comment
// TODO: BarIndex - add argument and description to function comment
@ -579,7 +579,7 @@ PciIoIoWrite (
IN UINTN Count,
IN OUT VOID *Buffer
)
/*++
/**
Routine Description:
@ -591,7 +591,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Width - add argument and description to function comment
// TODO: BarIndex - add argument and description to function comment
@ -639,7 +639,7 @@ PciIoConfigRead (
IN UINTN Count,
IN OUT VOID *Buffer
)
/*++
/**
Routine Description:
@ -651,7 +651,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Width - add argument and description to function comment
// TODO: Offset - add argument and description to function comment
@ -694,7 +694,7 @@ PciIoConfigWrite (
IN UINTN Count,
IN OUT VOID *Buffer
)
/*++
/**
Routine Description:
@ -706,7 +706,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Width - add argument and description to function comment
// TODO: Offset - add argument and description to function comment
@ -751,7 +751,7 @@ PciIoCopyMem (
IN UINT64 SrcOffset,
IN UINTN Count
)
/*++
/**
Routine Description:
@ -763,7 +763,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Width - add argument and description to function comment
// TODO: DestBarIndex - add argument and description to function comment
@ -831,7 +831,7 @@ PciIoMap (
OUT EFI_PHYSICAL_ADDRESS *DeviceAddress,
OUT VOID **Mapping
)
/*++
/**
Routine Description:
@ -843,7 +843,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Operation - add argument and description to function comment
// TODO: HostAddress - add argument and description to function comment
@ -892,7 +892,7 @@ PciIoUnmap (
IN EFI_PCI_IO_PROTOCOL *This,
IN VOID *Mapping
)
/*++
/**
Routine Description:
@ -904,7 +904,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Mapping - add argument and description to function comment
{
@ -935,7 +935,7 @@ PciIoAllocateBuffer (
OUT VOID **HostAddress,
IN UINT64 Attributes
)
/*++
/**
Routine Description:
@ -947,7 +947,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Type - add argument and description to function comment
// TODO: MemoryType - add argument and description to function comment
@ -993,7 +993,7 @@ PciIoFreeBuffer (
IN UINTN Pages,
IN VOID *HostAddress
)
/*++
/**
Routine Description:
@ -1005,7 +1005,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Pages - add argument and description to function comment
// TODO: HostAddress - add argument and description to function comment
@ -1033,7 +1033,7 @@ EFIAPI
PciIoFlush (
IN EFI_PCI_IO_PROTOCOL *This
)
/*++
/**
Routine Description:
@ -1045,7 +1045,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
{
EFI_STATUS Status;
@ -1072,7 +1072,7 @@ PciIoGetLocation (
OUT UINTN *Device,
OUT UINTN *Function
)
/*++
/**
Routine Description:
@ -1084,7 +1084,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Segment - add argument and description to function comment
// TODO: Bus - add argument and description to function comment
@ -1115,7 +1115,7 @@ CheckBarType (
UINT8 BarIndex,
PCI_BAR_TYPE BarType
)
/*++
/**
Routine Description:
@ -1127,7 +1127,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: BarIndex - add argument and description to function comment
// TODO: BarType - add argument and description to function comment
@ -1166,7 +1166,7 @@ ModifyRootBridgeAttributes (
IN UINT64 Attributes,
IN EFI_PCI_IO_PROTOCOL_ATTRIBUTE_OPERATION Operation
)
/*++
/**
Routine Description:
@ -1178,7 +1178,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: Attributes - add argument and description to function comment
// TODO: Operation - add argument and description to function comment
@ -1244,7 +1244,7 @@ SupportPaletteSnoopAttributes (
IN PCI_IO_DEVICE *PciIoDevice,
IN EFI_PCI_IO_PROTOCOL_ATTRIBUTE_OPERATION Operation
)
/*++
/**
Routine Description:
@ -1256,7 +1256,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: Operation - add argument and description to function comment
// TODO: EFI_UNSUPPORTED - add return value to function comment
@ -1372,7 +1372,7 @@ PciIoAttributes (
IN UINT64 Attributes,
OUT UINT64 *Result OPTIONAL
)
/*++
/**
Routine Description:
@ -1383,7 +1383,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Operation - add argument and description to function comment
// TODO: Attributes - add argument and description to function comment
@ -1666,7 +1666,7 @@ PciIoGetBarAttributes (
OUT UINT64 *Supports, OPTIONAL
OUT VOID **Resources OPTIONAL
)
/*++
/**
Routine Description:
@ -1677,7 +1677,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: BarIndex - add argument and description to function comment
// TODO: Supports - add argument and description to function comment
@ -1830,7 +1830,7 @@ PciIoSetBarAttributes (
IN OUT UINT64 *Offset,
IN OUT UINT64 *Length
)
/*++
/**
Routine Description:
@ -1841,7 +1841,7 @@ Returns:
None
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Attributes - add argument and description to function comment
// TODO: BarIndex - add argument and description to function comment
@ -1905,7 +1905,7 @@ UpStreamBridgesAttributes (
IN EFI_PCI_IO_PROTOCOL_ATTRIBUTE_OPERATION Operation,
IN UINT64 Attributes
)
/*++
/**
Routine Description:
@ -1915,7 +1915,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: Operation - add argument and description to function comment
// TODO: Attributes - add argument and description to function comment
@ -1946,7 +1946,7 @@ PciDevicesOnTheSamePath (
IN PCI_IO_DEVICE *PciDevice1,
IN PCI_IO_DEVICE *PciDevice2
)
/*++
/**
Routine Description:
@ -1956,7 +1956,7 @@ Returns:
None
--*/
**/
// TODO: PciDevice1 - add argument and description to function comment
// TODO: PciDevice2 - add argument and description to function comment
{

104
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciIo.h
View File

@ -19,7 +19,7 @@ EFI_STATUS
InitializePciIoInstance (
PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -33,7 +33,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -45,7 +45,7 @@ PciIoVerifyBarAccess (
IN UINTN Count,
UINT64 *Offset
)
/*++
/**
Routine Description:
@ -64,7 +64,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -74,7 +74,7 @@ PciIoVerifyConfigAccess (
IN UINTN Count,
IN UINT64 *Offset
)
/*++
/**
Routine Description:
@ -91,7 +91,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -106,7 +106,7 @@ PciIoPollMem (
IN UINT64 Delay,
OUT UINT64 *Result
)
/*++
/**
Routine Description:
@ -127,7 +127,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -142,7 +142,7 @@ PciIoPollIo (
IN UINT64 Delay,
OUT UINT64 *Result
)
/*++
/**
Routine Description:
@ -163,7 +163,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -176,7 +176,7 @@ PciIoMemRead (
IN UINTN Count,
IN OUT VOID *Buffer
)
/*++
/**
Routine Description:
@ -195,7 +195,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -208,7 +208,7 @@ PciIoMemWrite (
IN UINTN Count,
IN OUT VOID *Buffer
)
/*++
/**
Routine Description:
@ -227,7 +227,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -240,7 +240,7 @@ PciIoIoRead (
IN UINTN Count,
IN OUT VOID *Buffer
)
/*++
/**
Routine Description:
@ -259,7 +259,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -272,7 +272,7 @@ PciIoIoWrite (
IN UINTN Count,
IN OUT VOID *Buffer
)
/*++
/**
Routine Description:
@ -291,7 +291,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -303,7 +303,7 @@ PciIoConfigRead (
IN UINTN Count,
IN OUT VOID *Buffer
)
/*++
/**
Routine Description:
@ -321,7 +321,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -333,7 +333,7 @@ PciIoConfigWrite (
IN UINTN Count,
IN OUT VOID *Buffer
)
/*++
/**
Routine Description:
@ -351,7 +351,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -365,7 +365,7 @@ PciIoCopyMem (
IN UINT64 SrcOffset,
IN UINTN Count
)
/*++
/**
Routine Description:
@ -385,7 +385,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -398,7 +398,7 @@ PciIoMap (
OUT EFI_PHYSICAL_ADDRESS *DeviceAddress,
OUT VOID **Mapping
)
/*++
/**
Routine Description:
@ -417,7 +417,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -426,7 +426,7 @@ PciIoUnmap (
IN EFI_PCI_IO_PROTOCOL *This,
IN VOID *Mapping
)
/*++
/**
Routine Description:
@ -441,7 +441,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -454,7 +454,7 @@ PciIoAllocateBuffer (
OUT VOID **HostAddress,
IN UINT64 Attributes
)
/*++
/**
Routine Description:
@ -473,7 +473,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -483,7 +483,7 @@ PciIoFreeBuffer (
IN UINTN Pages,
IN VOID *HostAddress
)
/*++
/**
Routine Description:
@ -499,7 +499,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -507,7 +507,7 @@ EFIAPI
PciIoFlush (
IN EFI_PCI_IO_PROTOCOL *This
)
/*++
/**
Routine Description:
@ -521,7 +521,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -533,7 +533,7 @@ PciIoGetLocation (
OUT UINTN *Device,
OUT UINTN *Function
)
/*++
/**
Routine Description:
@ -551,7 +551,7 @@ Returns:
TODO: add return values
--*/
**/
;
BOOLEAN
@ -560,7 +560,7 @@ CheckBarType (
UINT8 BarIndex,
PCI_BAR_TYPE BarType
)
/*++
/**
Routine Description:
@ -576,7 +576,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -585,7 +585,7 @@ ModifyRootBridgeAttributes (
IN UINT64 Attributes,
IN EFI_PCI_IO_PROTOCOL_ATTRIBUTE_OPERATION Operation
)
/*++
/**
Routine Description:
@ -601,7 +601,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -609,7 +609,7 @@ SupportPaletteSnoopAttributes (
IN PCI_IO_DEVICE *PciIoDevice,
IN EFI_PCI_IO_PROTOCOL_ATTRIBUTE_OPERATION Operation
)
/*++
/**
Routine Description:
@ -624,7 +624,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -635,7 +635,7 @@ PciIoAttributes (
IN UINT64 Attributes,
OUT UINT64 *Result OPTIONAL
)
/*++
/**
Routine Description:
@ -652,7 +652,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -663,7 +663,7 @@ PciIoGetBarAttributes (
OUT UINT64 *Supports, OPTIONAL
OUT VOID **Resources OPTIONAL
)
/*++
/**
Routine Description:
@ -680,7 +680,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -692,7 +692,7 @@ PciIoSetBarAttributes (
IN OUT UINT64 *Offset,
IN OUT UINT64 *Length
)
/*++
/**
Routine Description:
@ -710,7 +710,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -719,7 +719,7 @@ UpStreamBridgesAttributes (
IN EFI_PCI_IO_PROTOCOL_ATTRIBUTE_OPERATION Operation,
IN UINT64 Attributes
)
/*++
/**
Routine Description:
@ -735,7 +735,7 @@ Returns:
TODO: add return values
--*/
**/
;
BOOLEAN
@ -743,7 +743,7 @@ PciDevicesOnTheSamePath (
IN PCI_IO_DEVICE *PciDevice1,
IN PCI_IO_DEVICE *PciDevice2
)
/*++
/**
Routine Description:
@ -758,7 +758,7 @@ Returns:
TODO: add return values
--*/
**/
;
#endif

48
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciLib.c
View File

@ -26,7 +26,7 @@ VOID
InstallHotPlugRequestProtocol (
IN EFI_STATUS *Status
)
/*++
/**
Routine Description:
@ -37,7 +37,7 @@ Returns:
None
--*/
**/
{
EFI_HANDLE Handle;
@ -58,7 +58,7 @@ VOID
InstallPciHotplugGuid (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -70,7 +70,7 @@ Returns:
None
--*/
**/
{
EFI_STATUS Status;
@ -94,7 +94,7 @@ VOID
UninstallPciHotplugGuid (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -106,7 +106,7 @@ Returns:
None
--*/
**/
{
EFI_STATUS Status;
@ -140,7 +140,7 @@ VOID
GetBackPcCardBar (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -153,7 +153,7 @@ Returns:
None
--*/
**/
{
UINT32 Address;
@ -227,7 +227,7 @@ RemoveRejectedPciDevices (
EFI_HANDLE RootBridgeHandle,
IN PCI_IO_DEVICE *Bridge
)
/*++
/**
Routine Description:
@ -241,7 +241,7 @@ Returns:
None
--*/
**/
// TODO: EFI_SUCCESS - add return value to function comment
{
PCI_IO_DEVICE *Temp;
@ -316,7 +316,7 @@ EFI_STATUS
PciHostBridgeResourceAllocator_WithoutHotPlugDeviceSupport (
IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *PciResAlloc
)
/*++
/**
Routine Description:
@ -326,7 +326,7 @@ Returns:
None
--*/
**/
// TODO: PciResAlloc - add argument and description to function comment
// TODO: EFI_NOT_FOUND - add return value to function comment
// TODO: EFI_OUT_OF_RESOURCES - add return value to function comment
@ -689,7 +689,7 @@ EFI_STATUS
PciHostBridgeResourceAllocator_WithHotPlugDeviceSupport (
IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *PciResAlloc
)
/*++
/**
Routine Description:
@ -703,7 +703,7 @@ Returns:
EFI Status.
--*/
**/
// TODO: EFI_NOT_FOUND - add return value to function comment
// TODO: EFI_NOT_FOUND - add return value to function comment
// TODO: EFI_NOT_FOUND - add return value to function comment
@ -1224,7 +1224,7 @@ PciScanBus_WithoutHotPlugDeviceSupport (
OUT UINT8 *SubBusNumber,
OUT UINT8 *PaddedBusRange
)
/*++
/**
Routine Description:
@ -1236,7 +1236,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: StartBusNumber - add argument and description to function comment
// TODO: SubBusNumber - add argument and description to function comment
@ -1409,7 +1409,7 @@ PciScanBus_WithHotPlugDeviceSupport (
OUT UINT8 *SubBusNumber,
OUT UINT8 *PaddedBusRange
)
/*++
/**
Routine Description:
@ -1426,7 +1426,7 @@ Returns:
None
--*/
**/
// TODO: EFI_DEVICE_ERROR - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment
{
@ -1704,7 +1704,7 @@ EFI_STATUS
PciRootBridgeP2CProcess (
IN PCI_IO_DEVICE *Bridge
)
/*++
/**
Routine Description:
@ -1716,7 +1716,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
{
@ -1782,7 +1782,7 @@ EFI_STATUS
PciHostBridgeP2CProcess (
IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *PciResAlloc
)
/*++
/**
Routine Description:
@ -1792,7 +1792,7 @@ Returns:
None
--*/
**/
// TODO: PciResAlloc - add argument and description to function comment
// TODO: EFI_NOT_FOUND - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -1833,7 +1833,7 @@ EFI_STATUS
PciHostBridgeEnumerator (
EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *PciResAlloc
)
/*++
/**
Routine Description:
@ -1848,7 +1848,7 @@ Returns:
None
--*/
**/
// TODO: EFI_OUT_OF_RESOURCES - add return value to function comment
// TODO: EFI_OUT_OF_RESOURCES - add return value to function comment
// TODO: EFI_OUT_OF_RESOURCES - add return value to function comment

40
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciLib.h
View File

@ -53,7 +53,7 @@ void
InstallHotPlugRequestProtocol (
IN EFI_STATUS *Status
)
/*++
/**
Routine Description:
@ -67,14 +67,14 @@ Returns:
TODO: add return values
--*/
**/
;
VOID
InstallPciHotplugGuid (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -88,14 +88,14 @@ Returns:
TODO: add return values
--*/
**/
;
VOID
UninstallPciHotplugGuid (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -109,14 +109,14 @@ Returns:
TODO: add return values
--*/
**/
;
VOID
GetBackPcCardBar (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -130,7 +130,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -138,7 +138,7 @@ RemoveRejectedPciDevices (
EFI_HANDLE RootBridgeHandle,
IN PCI_IO_DEVICE *Bridge
)
/*++
/**
Routine Description:
@ -153,14 +153,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
PciHostBridgeResourceAllocator (
IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *PciResAlloc
)
/*++
/**
Routine Description:
@ -174,7 +174,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -196,7 +196,7 @@ PciScanBus (
OUT UINT8 *SubBusNumber,
OUT UINT8 *PaddedBusRange
)
/*++
/**
Routine Description:
@ -213,7 +213,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -238,7 +238,7 @@ EFI_STATUS
PciRootBridgeP2CProcess (
IN PCI_IO_DEVICE *Bridge
)
/*++
/**
Routine Description:
@ -252,14 +252,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
PciHostBridgeP2CProcess (
IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *PciResAlloc
)
/*++
/**
Routine Description:
@ -273,14 +273,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
PciHostBridgeEnumerator (
EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *PciResAlloc
)
/*++
/**
Routine Description:
@ -294,7 +294,7 @@ Returns:
TODO: add return values
--*/
**/
;
/**

16
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciOptionRomSupport.c
View File

@ -34,7 +34,7 @@ EFI_STATUS
GetOpRomInfo (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -42,7 +42,7 @@ Arguments:
Returns:
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: EFI_NOT_FOUND - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -130,7 +130,7 @@ LoadOpRomImage (
IN PCI_IO_DEVICE *PciDevice,
IN UINT64 RomBase
)
/*++
/**
Routine Description:
@ -140,7 +140,7 @@ Arguments:
Returns:
--*/
**/
// TODO: PciDevice - add argument and description to function comment
// TODO: RomBase - add argument and description to function comment
// TODO: EFI_OUT_OF_RESOURCES - add return value to function comment
@ -314,7 +314,7 @@ RomDecode (
IN UINT32 RomBar,
IN BOOLEAN Enable
)
/*++
/**
Routine Description:
@ -322,7 +322,7 @@ Arguments:
Returns:
--*/
**/
// TODO: PciDevice - add argument and description to function comment
// TODO: RomBarIndex - add argument and description to function comment
// TODO: RomBar - add argument and description to function comment
@ -399,7 +399,7 @@ EFI_STATUS
ProcessOpRomImage (
PCI_IO_DEVICE *PciDevice
)
/*++
/**
Routine Description:
@ -412,7 +412,7 @@ Returns:
EFI Status.
--*/
**/
{
UINT8 Indicator;
UINT32 ImageSize;

16
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciOptionRomSupport.h
View File

@ -18,7 +18,7 @@ EFI_STATUS
GetOpRomInfo (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -32,7 +32,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -40,7 +40,7 @@ LoadOpRomImage (
IN PCI_IO_DEVICE *PciDevice,
IN UINT64 RomBase
)
/*++
/**
Routine Description:
@ -55,7 +55,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -65,7 +65,7 @@ RomDecode (
IN UINT32 RomBar,
IN BOOLEAN Enable
)
/*++
/**
Routine Description:
@ -82,14 +82,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
ProcessOpRomImage (
PCI_IO_DEVICE *PciDevice
)
/*++
/**
Routine Description:
@ -103,7 +103,7 @@ Returns:
TODO: add return values
--*/
**/
;
#endif

4
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciPowerManagement.c
View File

@ -17,7 +17,7 @@ EFI_STATUS
ResetPowerManagementFeature (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -31,7 +31,7 @@ Returns:
None
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: EFI_UNSUPPORTED - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment

4
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciPowerManagement.h
View File

@ -18,7 +18,7 @@ EFI_STATUS
ResetPowerManagementFeature (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -32,7 +32,7 @@ Returns:
TODO: add return values
--*/
**/
;
#endif

104
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciResourceSupport.c
View File

@ -20,7 +20,7 @@ SkipVGAAperture (
OUT UINT64 *Start,
IN UINT64 Length
)
/*++
/**
Routine Description:
@ -32,7 +32,7 @@ Returns:
None
--*/
**/
// TODO: Start - add argument and description to function comment
// TODO: Length - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -62,7 +62,7 @@ SkipIsaAliasAperture (
OUT UINT64 *Start,
IN UINT64 Length
)
/*++
/**
Routine Description:
@ -74,7 +74,7 @@ Returns:
None
--*/
**/
// TODO: Start - add argument and description to function comment
// TODO: Length - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -106,7 +106,7 @@ InsertResourceNode (
PCI_RESOURCE_NODE *Bridge,
PCI_RESOURCE_NODE *ResNode
)
/*++
/**
Routine Description:
@ -119,7 +119,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: ResNode - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -159,7 +159,7 @@ MergeResourceTree (
PCI_RESOURCE_NODE *Res,
BOOLEAN TypeMerge
)
/*++
/**
Routine Description:
@ -177,7 +177,7 @@ Returns:
None
--*/
**/
// TODO: Dst - add argument and description to function comment
// TODO: Res - add argument and description to function comment
// TODO: TypeMerge - add argument and description to function comment
@ -208,7 +208,7 @@ EFI_STATUS
CalculateApertureIo16 (
IN PCI_RESOURCE_NODE *Bridge
)
/*++
/**
Routine Description:
@ -221,7 +221,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -349,7 +349,7 @@ EFI_STATUS
CalculateResourceAperture (
IN PCI_RESOURCE_NODE *Bridge
)
/*++
/**
Routine Description:
@ -362,7 +362,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -464,7 +464,7 @@ GetResourceFromDevice (
PCI_RESOURCE_NODE *Mem64Node,
PCI_RESOURCE_NODE *PMem64Node
)
/*++
/**
Routine Description:
@ -474,7 +474,7 @@ Returns:
None
--*/
**/
// TODO: PciDev - add argument and description to function comment
// TODO: IoNode - add argument and description to function comment
// TODO: Mem32Node - add argument and description to function comment
@ -617,7 +617,7 @@ CreateResourceNode (
IN PCI_BAR_TYPE ResType,
IN PCI_RESOURCE_USAGE ResUsage
)
/*++
/**
Routine Description:
@ -629,7 +629,7 @@ Returns:
None
--*/
**/
// TODO: PciDev - add argument and description to function comment
// TODO: Length - add argument and description to function comment
// TODO: Alignment - add argument and description to function comment
@ -677,7 +677,7 @@ CreateResourceMap (
IN PCI_RESOURCE_NODE *Mem64Node,
IN PCI_RESOURCE_NODE *PMem64Node
)
/*++
/**
Routine Description:
@ -690,7 +690,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: IoNode - add argument and description to function comment
// TODO: Mem32Node - add argument and description to function comment
@ -932,7 +932,7 @@ ResourcePaddingPolicy (
PCI_RESOURCE_NODE *Mem64Node,
PCI_RESOURCE_NODE *PMem64Node
)
/*++
/**
Routine Description:
@ -952,7 +952,7 @@ Returns:
None
--*/
**/
// TODO: EFI_SUCCESS - add return value to function comment
{
//
@ -981,7 +981,7 @@ DegradeResource (
IN PCI_RESOURCE_NODE *Mem64Node,
IN PCI_RESOURCE_NODE *PMem64Node
)
/*++
/**
Routine Description:
@ -997,7 +997,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: Mem32Node - add argument and description to function comment
// TODO: PMem32Node - add argument and description to function comment
@ -1083,7 +1083,7 @@ BridgeSupportResourceDecode (
IN PCI_IO_DEVICE *Bridge,
IN UINT32 Decode
)
/*++
/**
Routine Description:
@ -1098,9 +1098,9 @@ Returns:
TODO: add return values
--*/
**/
{
/*++
/**
Routine Description:
@ -1110,7 +1110,7 @@ Returns:
None
--*/
**/
if ((Bridge->Decodes) & Decode) {
return TRUE;
}
@ -1123,7 +1123,7 @@ ProgramResource (
IN UINT64 Base,
IN PCI_RESOURCE_NODE *Bridge
)
/*++
/**
Routine Description:
@ -1136,7 +1136,7 @@ Returns:
None
--*/
**/
// TODO: Base - add argument and description to function comment
// TODO: Bridge - add argument and description to function comment
// TODO: EFI_OUT_OF_RESOURCES - add return value to function comment
@ -1184,7 +1184,7 @@ ProgramBar (
IN UINT64 Base,
IN PCI_RESOURCE_NODE *Node
)
/*++
/**
Routine Description:
@ -1194,7 +1194,7 @@ Returns:
None
--*/
**/
// TODO: Base - add argument and description to function comment
// TODO: Node - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -1274,7 +1274,7 @@ ProgramPpbApperture (
IN UINT64 Base,
IN PCI_RESOURCE_NODE *Node
)
/*++
/**
Routine Description:
@ -1284,7 +1284,7 @@ Returns:
None
--*/
**/
// TODO: Base - add argument and description to function comment
// TODO: Node - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -1456,7 +1456,7 @@ ProgrameUpstreamBridgeForRom (
IN UINT32 OptionRomBase,
IN BOOLEAN Enable
)
/*++
/**
Routine Description:
@ -1464,7 +1464,7 @@ Arguments:
Returns:
--*/
**/
// TODO: PciDevice - add argument and description to function comment
// TODO: OptionRomBase - add argument and description to function comment
// TODO: Enable - add argument and description to function comment
@ -1510,7 +1510,7 @@ BOOLEAN
ResourceRequestExisted (
IN PCI_RESOURCE_NODE *Bridge
)
/*++
/**
Routine Description:
@ -1522,7 +1522,7 @@ Returns:
None
--*/
**/
{
if (Bridge != NULL) {
if (!IsListEmpty (&Bridge->ChildList) || Bridge->Length != 0) {
@ -1538,7 +1538,7 @@ InitializeResourcePool (
PCI_RESOURCE_NODE *ResourcePool,
PCI_BAR_TYPE ResourceType
)
/*++
/**
Routine Description:
@ -1548,7 +1548,7 @@ Returns:
None
--*/
**/
// TODO: ResourcePool - add argument and description to function comment
// TODO: ResourceType - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -1576,7 +1576,7 @@ GetResourceMap (
PCI_RESOURCE_NODE *Mem64Pool,
PCI_RESOURCE_NODE *PMem64Pool
)
/*++
/**
Routine Description:
@ -1586,7 +1586,7 @@ Returns:
None
--*/
**/
// TODO: PciDev - add argument and description to function comment
// TODO: IoBridge - add argument and description to function comment
// TODO: Mem32Bridge - add argument and description to function comment
@ -1691,7 +1691,7 @@ EFI_STATUS
DestroyResourceTree (
IN PCI_RESOURCE_NODE *Bridge
)
/*++
/**
Routine Description:
@ -1701,7 +1701,7 @@ Returns:
None
--*/
**/
// TODO: Bridge - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
{
@ -1733,7 +1733,7 @@ RecordReservedResource (
IN PCI_BAR_TYPE ResType,
IN PCI_IO_DEVICE *Bridge
)
/*++
/**
Routine Description:
@ -1743,7 +1743,7 @@ Returns:
None
--*/
**/
// TODO: Base - add argument and description to function comment
// TODO: Length - add argument and description to function comment
// TODO: ResType - add argument and description to function comment
@ -1777,7 +1777,7 @@ ResourcePaddingForCardBusBridge (
PCI_RESOURCE_NODE *Mem64Node,
PCI_RESOURCE_NODE *PMem64Node
)
/*++
/**
Routine Description:
@ -1787,7 +1787,7 @@ Returns:
None
--*/
**/
// TODO: PciDev - add argument and description to function comment
// TODO: IoNode - add argument and description to function comment
// TODO: Mem32Node - add argument and description to function comment
@ -1880,7 +1880,7 @@ ProgramP2C (
IN UINT64 Base,
IN PCI_RESOURCE_NODE *Node
)
/*++
/**
Routine Description:
@ -1890,7 +1890,7 @@ Returns:
None
--*/
**/
// TODO: Base - add argument and description to function comment
// TODO: Node - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
@ -2127,7 +2127,7 @@ ApplyResourcePadding (
PCI_RESOURCE_NODE *Mem64Node,
PCI_RESOURCE_NODE *PMem64Node
)
/*++
/**
Routine Description:
@ -2137,7 +2137,7 @@ Returns:
None
--*/
**/
// TODO: PciDev - add argument and description to function comment
// TODO: IoNode - add argument and description to function comment
// TODO: Mem32Node - add argument and description to function comment
@ -2291,7 +2291,7 @@ VOID
GetResourcePaddingPpb (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -2305,7 +2305,7 @@ Returns:
None
--*/
**/
{
if (gPciHotPlugInit) {
if (PciIoDevice->ResourcePaddingDescriptors == NULL) {

104
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciResourceSupport.h
View File

@ -64,7 +64,7 @@ SkipVGAAperture (
OUT UINT64 *Start,
IN UINT64 Length
)
/*++
/**
Routine Description:
@ -79,7 +79,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -87,7 +87,7 @@ SkipIsaAliasAperture (
OUT UINT64 *Start,
IN UINT64 Length
)
/*++
/**
Routine Description:
@ -102,7 +102,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -110,7 +110,7 @@ InsertResourceNode (
PCI_RESOURCE_NODE *Bridge,
PCI_RESOURCE_NODE *ResNode
)
/*++
/**
Routine Description:
@ -125,7 +125,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -134,7 +134,7 @@ MergeResourceTree (
PCI_RESOURCE_NODE *Res,
BOOLEAN TypeMerge
)
/*++
/**
Routine Description:
@ -150,14 +150,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
CalculateApertureIo16 (
IN PCI_RESOURCE_NODE *Bridge
)
/*++
/**
Routine Description:
@ -171,14 +171,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
CalculateResourceAperture (
IN PCI_RESOURCE_NODE *Bridge
)
/*++
/**
Routine Description:
@ -192,7 +192,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -204,7 +204,7 @@ GetResourceFromDevice (
PCI_RESOURCE_NODE *Mem64Node,
PCI_RESOURCE_NODE *PMem64Node
)
/*++
/**
Routine Description:
@ -223,7 +223,7 @@ Returns:
TODO: add return values
--*/
**/
;
PCI_RESOURCE_NODE *
@ -235,7 +235,7 @@ CreateResourceNode (
IN PCI_BAR_TYPE ResType,
IN PCI_RESOURCE_USAGE ResUsage
)
/*++
/**
Routine Description:
@ -254,7 +254,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -266,7 +266,7 @@ CreateResourceMap (
IN PCI_RESOURCE_NODE *Mem64Node,
IN PCI_RESOURCE_NODE *PMem64Node
)
/*++
/**
Routine Description:
@ -285,7 +285,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -297,7 +297,7 @@ ResourcePaddingPolicy (
PCI_RESOURCE_NODE *Mem64Node,
PCI_RESOURCE_NODE *PMem64Node
)
/*++
/**
Routine Description:
@ -316,7 +316,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -327,7 +327,7 @@ DegradeResource (
IN PCI_RESOURCE_NODE *Mem64Node,
IN PCI_RESOURCE_NODE *PMem64Node
)
/*++
/**
Routine Description:
@ -345,7 +345,7 @@ Returns:
TODO: add return values
--*/
**/
;
BOOLEAN
@ -353,7 +353,7 @@ BridgeSupportResourceDecode (
IN PCI_IO_DEVICE *Bridge,
IN UINT32 Decode
)
/*++
/**
Routine Description:
@ -368,7 +368,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -376,7 +376,7 @@ ProgramResource (
IN UINT64 Base,
IN PCI_RESOURCE_NODE *Bridge
)
/*++
/**
Routine Description:
@ -391,7 +391,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -399,7 +399,7 @@ ProgramBar (
IN UINT64 Base,
IN PCI_RESOURCE_NODE *Node
)
/*++
/**
Routine Description:
@ -414,7 +414,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -422,7 +422,7 @@ ProgramPpbApperture (
IN UINT64 Base,
IN PCI_RESOURCE_NODE *Node
)
/*++
/**
Routine Description:
@ -437,7 +437,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -446,7 +446,7 @@ ProgrameUpstreamBridgeForRom (
IN UINT32 OptionRomBase,
IN BOOLEAN Enable
)
/*++
/**
Routine Description:
@ -462,14 +462,14 @@ Returns:
TODO: add return values
--*/
**/
;
BOOLEAN
ResourceRequestExisted (
IN PCI_RESOURCE_NODE *Bridge
)
/*++
/**
Routine Description:
@ -483,7 +483,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -491,7 +491,7 @@ InitializeResourcePool (
PCI_RESOURCE_NODE *ResourcePool,
PCI_BAR_TYPE ResourceType
)
/*++
/**
Routine Description:
@ -506,7 +506,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -523,7 +523,7 @@ GetResourceMap (
PCI_RESOURCE_NODE *Mem64Pool,
PCI_RESOURCE_NODE *PMem64Pool
)
/*++
/**
Routine Description:
@ -547,14 +547,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
DestroyResourceTree (
IN PCI_RESOURCE_NODE *Bridge
)
/*++
/**
Routine Description:
@ -568,7 +568,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -578,7 +578,7 @@ RecordReservedResource (
IN PCI_BAR_TYPE ResType,
IN PCI_IO_DEVICE *Bridge
)
/*++
/**
Routine Description:
@ -595,7 +595,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -607,7 +607,7 @@ ResourcePaddingForCardBusBridge (
PCI_RESOURCE_NODE *Mem64Node,
PCI_RESOURCE_NODE *PMem64Node
)
/*++
/**
Routine Description:
@ -626,7 +626,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -634,7 +634,7 @@ ProgramP2C (
IN UINT64 Base,
IN PCI_RESOURCE_NODE *Node
)
/*++
/**
Routine Description:
@ -649,7 +649,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -661,7 +661,7 @@ ApplyResourcePadding (
PCI_RESOURCE_NODE *Mem64Node,
PCI_RESOURCE_NODE *PMem64Node
)
/*++
/**
Routine Description:
@ -680,14 +680,14 @@ Returns:
TODO: add return values
--*/
**/
;
VOID
GetResourcePaddingPpb (
IN PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -701,7 +701,7 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
@ -709,7 +709,7 @@ ResetAllPpbBusNumber (
IN PCI_IO_DEVICE *Bridge,
IN UINT8 StartBusNumber
)
/*++
/**
Routine Description:
@ -724,7 +724,7 @@ Returns:
None
--*/
**/
;
#endif

12
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.c
View File

@ -39,7 +39,7 @@ PciRomAddImageMapping (
IN UINT64 RomAddress,
IN UINT64 RomLength
)
/*++
/**
Routine Description:
@ -59,7 +59,7 @@ Returns:
TODO: add return values
--*/
**/
{
EFI_PCI_ROM_IMAGE_MAPPING *TempMapping;
@ -98,7 +98,7 @@ PciRomGetRomResourceFromPciOptionRomTable (
IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *PciRootBridgeIo,
PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -106,7 +106,7 @@ Arguments:
Returns:
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: PciRootBridgeIo - add argument and description to function comment
// TODO: PciIoDevice - add argument and description to function comment
@ -152,7 +152,7 @@ EFI_STATUS
PciRomGetImageMapping (
PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -160,7 +160,7 @@ Arguments:
Returns:
--*/
**/
// TODO: PciIoDevice - add argument and description to function comment
// TODO: EFI_SUCCESS - add return value to function comment
{

12
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.h
View File

@ -25,7 +25,7 @@ PciRomAddImageMapping (
IN UINT64 RomAddress,
IN UINT64 RomLength
)
/*++
/**
Routine Description:
@ -45,7 +45,7 @@ Returns:
TODO: add return values
--*/
**/
;
@ -55,7 +55,7 @@ PciRomGetRomResourceFromPciOptionRomTable (
IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *PciRootBridgeIo,
PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -71,14 +71,14 @@ Returns:
TODO: add return values
--*/
**/
;
EFI_STATUS
PciRomGetImageMapping (
PCI_IO_DEVICE *PciIoDevice
)
/*++
/**
Routine Description:
@ -92,7 +92,7 @@ Returns:
TODO: add return values
--*/
**/
;
#endif

16
IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/pcibus.c
View File

@ -45,7 +45,7 @@ PciBusEntryPoint (
IN EFI_HANDLE ImageHandle,
IN EFI_SYSTEM_TABLE *SystemTable
)
/*++
/**
Routine Description:
@ -62,7 +62,7 @@ Returns:
EFI_SUCCESS
EFI_DEVICE_ERROR
--*/
**/
// TODO: ImageHandle - add argument and description to function comment
// TODO: SystemTable - add argument and description to function comment
{
@ -99,7 +99,7 @@ PciBusDriverBindingSupported (
IN EFI_HANDLE Controller,
IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath
)
/*++
/**
Routine Description:
@ -115,7 +115,7 @@ Returns:
EFI_SUCCESS
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Controller - add argument and description to function comment
// TODO: RemainingDevicePath - add argument and description to function comment
@ -193,7 +193,7 @@ PciBusDriverBindingStart (
IN EFI_HANDLE Controller,
IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath
)
/*++
/**
Routine Description:
@ -208,7 +208,7 @@ Arguments:
Returns:
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Controller - add argument and description to function comment
// TODO: RemainingDevicePath - add argument and description to function comment
@ -262,7 +262,7 @@ PciBusDriverBindingStop (
IN UINTN NumberOfChildren,
IN EFI_HANDLE *ChildHandleBuffer
)
/*++
/**
Routine Description:
@ -279,7 +279,7 @@ Arguments:
Returns:
--*/
**/
// TODO: This - add argument and description to function comment
// TODO: Controller - add argument and description to function comment
// TODO: NumberOfChildren - add argument and description to function comment