Device_Io.pcidevicepath() - Intel Extensible Firmware Interface Specification

6.2.2

DEVICE_IO.PciDevicePath()

Summary
Provides an EFI Device Path for a PCI device with the given PCI configuration space address.
Prototype
typedef
EFI_STATUS
(EFIAPI *EFI_PCI_DEVICE_PATH) (
IN EFI_DEVICE_IO_INTERFACE
IN UINT64
IN OUT EFI_DEVICE_PATH
);
Parameters
This
PciAddress
PciDevicePath
Description
The
DEVICE_IO.PciDevicePath()
with the given PCI configuration space address.
A Device Path for the requested PCI device is returned in PciDevicePath.
PciDevicePath()
caller is responsible for calling
If there is not enough memory to calculate or return the
EFI_OUT_OF_RESOURCES. If the function can not calculate a valid Device Path for
the function will return EFI_UNSUPPORTED.
PciAddress
Status Codes Returned
EFI_SUCCESS
EFI_UNSUPPORTED
EFI_OUT_OF_RESOURCES
Version 1.02
A pointer to the EFI_DEVICE_IO_INTERFACE. Type
EFI_DEVICE_IO_INTERFACE
The PCI configuration space address of the device whose Device Path is
going to be returned. The address field is encoded as shown in
Table 6-1.
A pointer to the pointer for the EFI Device Path for PciAddress.
Memory for the Device Path is allocated from the pool. Type
EFI_DEVICE_PATH
function provides an EFI Device Path for a PCI device
allocates the memory required for the Device Path from the pool and the
to free the memory used to contain the Device Path.
FreePool()
PciDevicePath
The
PciAddress
The
The request could not be completed due to a lack of resources.
*This,
PciAddress,
**PciDevicePath
is defined in Section 6.2.
is defined in Chapter 3.
PciDevicePath
returns a pointer to a valid EFI Device Path
does not map to a valid EFI Device Path.
12/12/00
Device I/O Protocol
the function will return
.
143