2 PCI Rom supporting funtions declaration for PCI Bus module.
4 Copyright (c) 2006 - 2012, Intel Corporation. All rights reserved.<BR>
5 This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
15 #ifndef _EFI_PCI_OPTION_ROM_SUPPORT_H_
16 #define _EFI_PCI_OPTION_ROM_SUPPORT_H_
20 Initialize a PCI LoadFile2 instance.
22 @param PciIoDevice PCI IO Device.
26 InitializePciLoadFile2 (
27 IN PCI_IO_DEVICE
*PciIoDevice
31 Causes the driver to load a specified file.
33 @param This Indicates a pointer to the calling context.
34 @param FilePath The device specific path of the file to load.
35 @param BootPolicy Should always be FALSE.
36 @param BufferSize On input the size of Buffer in bytes. On output with a return
37 code of EFI_SUCCESS, the amount of data transferred to Buffer.
38 On output with a return code of EFI_BUFFER_TOO_SMALL,
39 the size of Buffer required to retrieve the requested file.
40 @param Buffer The memory buffer to transfer the file to. If Buffer is NULL,
41 then no the size of the requested file is returned in BufferSize.
43 @retval EFI_SUCCESS The file was loaded.
44 @retval EFI_UNSUPPORTED BootPolicy is TRUE.
45 @retval EFI_INVALID_PARAMETER FilePath is not a valid device path, or
47 @retval EFI_NOT_FOUND Not found PCI Option Rom on PCI device.
48 @retval EFI_DEVICE_ERROR Failed to decompress PCI Option Rom image.
49 @retval EFI_BUFFER_TOO_SMALL The BufferSize is too small to read the current directory entry.
50 BufferSize has been updated with the size needed to complete the request.
56 IN EFI_LOAD_FILE2_PROTOCOL
*This
,
57 IN EFI_DEVICE_PATH_PROTOCOL
*FilePath
,
58 IN BOOLEAN BootPolicy
,
59 IN OUT UINTN
*BufferSize
,
60 IN VOID
*Buffer OPTIONAL
64 Get Pci device's oprom information.
66 @param PciIoDevice Input Pci device instance.
67 Output Pci device instance with updated OptionRom size.
69 @retval EFI_NOT_FOUND Pci device has not Option Rom.
70 @retval EFI_SUCCESS Pci device has Option Rom.
75 IN OUT PCI_IO_DEVICE
*PciIoDevice
79 Load Option Rom image for specified PCI device.
81 @param PciDevice Pci device instance.
82 @param RomBase Base address of Option Rom.
84 @retval EFI_OUT_OF_RESOURCES No enough memory to hold image.
85 @retval EFI_SUCESS Successfully loaded Option Rom.
90 IN PCI_IO_DEVICE
*PciDevice
,
95 Enable/Disable Option Rom decode.
97 @param PciDevice Pci device instance.
98 @param RomBarIndex The BAR index of the standard PCI Configuration header to use as the
99 base address for resource range. The legal range for this field is 0..5.
100 @param RomBar Base address of Option Rom.
101 @param Enable Flag for enable/disable decode.
106 IN PCI_IO_DEVICE
*PciDevice
,
107 IN UINT8 RomBarIndex
,
113 Load and start the Option Rom image.
115 @param PciDevice Pci device instance.
117 @retval EFI_SUCCESS Successfully loaded and started PCI Option Rom image.
118 @retval EFI_NOT_FOUND Failed to process PCI Option Rom image.
123 IN PCI_IO_DEVICE
*PciDevice