diff options
Diffstat (limited to 'IntelFrameworkModulePkg/Bus/Pci')
26 files changed, 630 insertions, 630 deletions
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciCommand.c b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciCommand.c index 8cd5acfc00..13d459b864 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciCommand.c +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciCommand.c @@ -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
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciCommand.h b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciCommand.h index 248aa6132e..b6f877b974 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciCommand.h +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciCommand.h @@ -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
---*/
+**/
;
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDeviceSupport.c b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDeviceSupport.c index d19ee04bf4..f37da70425 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDeviceSupport.c +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDeviceSupport.c @@ -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
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDeviceSupport.h b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDeviceSupport.h index b32dfe214a..75707fdd10 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDeviceSupport.h +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDeviceSupport.h @@ -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
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDriverOverride.c b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDriverOverride.c index f05c5b198c..93f58ed3ec 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDriverOverride.c +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDriverOverride.c @@ -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
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDriverOverride.h b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDriverOverride.h index 5806f2702b..013d74a9dd 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDriverOverride.h +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciDriverOverride.h @@ -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
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumerator.c b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumerator.c index d64a6018e1..9e68da8afe 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumerator.c +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumerator.c @@ -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
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumerator.h b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumerator.h index 20e0f7eae9..3ed98f85f5 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumerator.h +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumerator.h @@ -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
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.c b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.c index 0a5292e796..2aa85c5856 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.c +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.c @@ -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;
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.h b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.h index a9c49b2c92..b7b467298c 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.h +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.h @@ -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
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciHotPlugSupport.c b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciHotPlugSupport.c index 0883d0d2dd..ee95864f1b 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciHotPlugSupport.c +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciHotPlugSupport.c @@ -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
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciHotPlugSupport.h b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciHotPlugSupport.h index 182afd1ff6..c1d74a3086 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciHotPlugSupport.h +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciHotPlugSupport.h @@ -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
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciIo.c b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciIo.c index 765cf4c87a..79ebe5fabd 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciIo.c +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciIo.c @@ -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
{
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciIo.h b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciIo.h index 2713b72eae..6c6d739c62 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciIo.h +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciIo.h @@ -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
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciLib.c b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciLib.c index d35fe0d042..ed4588f842 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciLib.c +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciLib.c @@ -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
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciLib.h b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciLib.h index 868943a6d2..b8dc2a61f3 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciLib.h +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciLib.h @@ -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
---*/
+**/
;
/**
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciOptionRomSupport.c b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciOptionRomSupport.c index 05339f3afb..bf087821c5 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciOptionRomSupport.c +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciOptionRomSupport.c @@ -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;
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciOptionRomSupport.h b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciOptionRomSupport.h index 752708d1a5..e06edd4c17 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciOptionRomSupport.h +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciOptionRomSupport.h @@ -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
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciPowerManagement.c b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciPowerManagement.c index 338cfe9824..0cbbb36880 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciPowerManagement.c +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciPowerManagement.c @@ -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
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciPowerManagement.h b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciPowerManagement.h index 6853e4f2ac..1239eed2ec 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciPowerManagement.h +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciPowerManagement.h @@ -18,7 +18,7 @@ EFI_STATUS ResetPowerManagementFeature (
IN PCI_IO_DEVICE *PciIoDevice
)
-/*++
+/**
Routine Description:
@@ -32,7 +32,7 @@ Returns: TODO: add return values
---*/
+**/
;
#endif
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciResourceSupport.c b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciResourceSupport.c index 1db77d15ae..1521065780 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciResourceSupport.c +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciResourceSupport.c @@ -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) {
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciResourceSupport.h b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciResourceSupport.h index 34a7787196..87d0b9146e 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciResourceSupport.h +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciResourceSupport.h @@ -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
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.c b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.c index 6c97601c1f..18ee0a89fa 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.c +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.c @@ -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
{
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.h b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.h index c161920bd4..9cb9966c85 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.h +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.h @@ -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
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/pcibus.c b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/pcibus.c index 94f29157e8..0569982191 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/pcibus.c +++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/pcibus.c @@ -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
diff --git a/IntelFrameworkModulePkg/Bus/Pci/VgaMiniPortDxe/VgaMiniPort.c b/IntelFrameworkModulePkg/Bus/Pci/VgaMiniPortDxe/VgaMiniPort.c index 4ebcc7ccc5..3b4a5e4fe9 100644 --- a/IntelFrameworkModulePkg/Bus/Pci/VgaMiniPortDxe/VgaMiniPort.c +++ b/IntelFrameworkModulePkg/Bus/Pci/VgaMiniPortDxe/VgaMiniPort.c @@ -42,7 +42,7 @@ PciVgaMiniPortDriverEntryPoint ( IN EFI_HANDLE ImageHandle,
IN EFI_SYSTEM_TABLE *SystemTable
)
-/*++
+/**
Routine Description:
Driver Entry Point.
@@ -52,7 +52,7 @@ PciVgaMiniPortDriverEntryPoint ( Returns:
EFI_STATUS
---*/
+**/
{
return EfiLibInstallDriverBindingComponentName2 (
ImageHandle,
|