summaryrefslogtreecommitdiff
path: root/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.c
diff options
context:
space:
mode:
authorklu2 <klu2@6f19259b-4bc3-4df7-8a09-765794883524>2008-04-16 09:24:58 +0000
committerklu2 <klu2@6f19259b-4bc3-4df7-8a09-765794883524>2008-04-16 09:24:58 +0000
commit57076f458585a61a0fa1afb9a6527bc7a625ed64 (patch)
tree5279a1b791f0a0b8fc5c557cd2426144449aa0ff /IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.c
parent0915f6dce444a96a4985f42539ff249aff17265c (diff)
downloadedk2-platforms-57076f458585a61a0fa1afb9a6527bc7a625ed64.tar.xz
Add function doxygen header for PciBus module.
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@5071 6f19259b-4bc3-4df7-8a09-765794883524
Diffstat (limited to 'IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.c')
-rw-r--r--IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.c70
1 files changed, 24 insertions, 46 deletions
diff --git a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.c b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.c
index 18ee0a89fa..bacd2ebd5d 100644
--- a/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.c
+++ b/IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciRomTable.c
@@ -29,6 +29,17 @@ static UINTN mNumberOfPciRomImages = 0;
static UINTN mMaxNumberOfPciRomImages = 0;
static EFI_PCI_ROM_IMAGE_MAPPING *mRomImageTable = NULL;
+/**
+ Add the Rom Image to internal database for later PCI light enumeration
+
+ @param ImageHandle Option Rom image handle
+ @param Seg Segment of PCI space
+ @param Bus Bus NO of PCI space
+ @param Dev Dev NO of PCI space
+ @param Func Func NO of PCI space
+ @param RomAddress Base address of OptionRom
+ @param RomLength Length of rom image.
+**/
VOID
PciRomAddImageMapping (
IN EFI_HANDLE ImageHandle,
@@ -39,27 +50,6 @@ PciRomAddImageMapping (
IN UINT64 RomAddress,
IN UINT64 RomLength
)
-/**
-
-Routine Description:
-
- TODO: Add function description
-
-Arguments:
-
- ImageHandle - TODO: add argument description
- Seg - TODO: add argument description
- Bus - TODO: add argument description
- Dev - TODO: add argument description
- Func - TODO: add argument description
- RomAddress - TODO: add argument description
- RomLength - TODO: add argument description
-
-Returns:
-
- TODO: add return values
-
-**/
{
EFI_PCI_ROM_IMAGE_MAPPING *TempMapping;
@@ -92,26 +82,19 @@ Returns:
mNumberOfPciRomImages++;
}
+/**
+ Load all option rom image to PCI driver list.
+
+ @param This Pointer to protocol instance EFI_DRIVER_BINDING_PROTOCOL
+ @param PciRootBridgeIo Root bridge Io instance
+ @param PciIoDevice device instance
+**/
EFI_STATUS
PciRomGetRomResourceFromPciOptionRomTable (
IN EFI_DRIVER_BINDING_PROTOCOL *This,
IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *PciRootBridgeIo,
PCI_IO_DEVICE *PciIoDevice
)
-/**
-
-Routine Description:
-
-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
-// TODO: EFI_NOT_FOUND - add return value to function comment
-// TODO: EFI_SUCCESS - add return value to function comment
{
EFI_STATUS Status;
EFI_PCI_OPTION_ROM_TABLE *PciOptionRomTable;
@@ -148,21 +131,16 @@ Returns:
return EFI_SUCCESS;
}
+/**
+ Get Option rom driver's mapping for PCI device.
+
+ @param PciIoDevice Device instance.
+
+**/
EFI_STATUS
PciRomGetImageMapping (
PCI_IO_DEVICE *PciIoDevice
)
-/**
-
-Routine Description:
-
-Arguments:
-
-Returns:
-
-**/
-// TODO: PciIoDevice - add argument and description to function comment
-// TODO: EFI_SUCCESS - add return value to function comment
{
EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *PciRootBridgeIo;
UINTN Index;