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

IntelFrameworkModulePkg/Bus/Pci/PciBusDxe/PciOptionRomSupport.h

@@ -14,50 +14,45 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #ifndef _EFI_PCI_OP_ROM_SUPPORT_H
 #define _EFI_PCI_OP_ROM_SUPPORT_H
 
+/**
+  Get Pci device's oprom infor bits.
+  
+  @retval EFI_NOT_FOUND Pci device has not oprom
+  @retval EFI_SUCCESS   Pci device has oprom
+**/
 EFI_STATUS
 GetOpRomInfo (
   IN PCI_IO_DEVICE    *PciIoDevice
   )
-/**
-
-Routine Description:
-
-  TODO: Add function description
-
-Arguments:
-
-  PciIoDevice - TODO: add argument description
-
-Returns:
-
-  TODO: add return values
-
-**/
 ;
 
+/**
+  Load option rom image for specified PCI device
+  
+  @param PciDevice Pci device instance
+  @param RomBase   Base address of oprom.
+  
+  @retval EFI_OUT_OF_RESOURCES not enough memory to hold image
+  @retval EFI_SUCESS           Success
+**/
 EFI_STATUS
 LoadOpRomImage (
   IN PCI_IO_DEVICE   *PciDevice,
   IN UINT64          RomBase
   )
-/**
-
-Routine Description:
-
-  TODO: Add function description
-
-Arguments:
-
-  PciDevice - TODO: add argument description
-  RomBase   - TODO: add argument description
-
-Returns:
-
-  TODO: add return values
-
-**/
 ;
 
+/**
+  enable/disable oprom decode
+  
+  @param PciDevice    pci device instance
+  @param RomBarIndex  The BAR index of the standard PCI Configuration header to use as the
+                      base address for resource range. The legal range for this field is 0..5.
+  @param RomBar       Base address of rom
+  @param Enable       Flag for enable/disable decode.
+  
+  @retval EFI_SUCCESS Success
+**/
 EFI_STATUS
 RomDecode (
   IN PCI_IO_DEVICE   *PciDevice,
@@ -65,45 +60,17 @@ RomDecode (
   IN UINT32          RomBar,
   IN BOOLEAN         Enable
   )
-/**
-
-Routine Description:
-
-  TODO: Add function description
-
-Arguments:
-
-  PciDevice   - TODO: add argument description
-  RomBarIndex - TODO: add argument description
-  RomBar      - TODO: add argument description
-  Enable      - TODO: add argument description
-
-Returns:
-
-  TODO: add return values
-
-**/
 ;
 
+/**
+  Process the oprom image.
+  
+  @param PciDevice Pci device instance
+**/
 EFI_STATUS
 ProcessOpRomImage (
   PCI_IO_DEVICE   *PciDevice
   )
-/**
-
-Routine Description:
-
-  TODO: Add function description
-
-Arguments:
-
-  PciDevice - TODO: add argument description
-
-Returns:
-
-  TODO: add return values
-
-**/
 ;
 
 #endif