PciCapPciSegmentLib.h File Reference

#include <Library/PciCapLib.h>

Go to the source code of this file.

Functions
RETURN_STATUS EFIAPI	PciCapPciSegmentDeviceInit (IN PCI_CAP_DOMAIN MaxDomain, IN UINT16 Segment, IN UINT8 Bus, IN UINT8 Device, IN UINT8 Function, OUT PCI_CAP_DEV **PciDevice)
VOID EFIAPI	PciCapPciSegmentDeviceUninit (IN PCI_CAP_DEV *PciDevice)

Detailed Description

Library class layered on top of PciCapLib that allows clients to plug a PciSegmentLib backend into PciCapLib, for config space access.

Copyright (C) 2018, Red Hat, Inc.

SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file PciCapPciSegmentLib.h.

Function Documentation

PciCapPciSegmentDeviceInit()

RETURN_STATUS EFIAPI PciCapPciSegmentDeviceInit	(	IN PCI_CAP_DOMAIN	MaxDomain,
		IN UINT16	Segment,
		IN UINT8	Bus,
		IN UINT8	Device,
		IN UINT8	Function,
		OUT PCI_CAP_DEV **	PciDevice
	)

Create a PCI_CAP_DEV object from the PCI Segment:Bus:Device.Function quadruplet. The config space accessors are based upon PciSegmentLib.

Parameters

[in]	MaxDomain	If MaxDomain is PciCapExtended, then PciDevice->ReadConfig() and PciDevice->WriteConfig() will delegate extended config space accesses too to PciSegmentReadBuffer() and PciSegmentWriteBuffer(), respectively. Otherwise, PciDevice->ReadConfig() and PciDevice->WriteConfig() will reject accesses to extended config space with RETURN_UNSUPPORTED, without calling PciSegmentReadBuffer() or PciSegmentWriteBuffer(). By setting MaxDomain to PciCapNormal, the platform can prevent undefined PciSegmentLib behavior when the PCI root bridge under the PCI device at Segment:Bus:Device.Function doesn't support extended config space.
[in]	Segment	16-bit wide segment number.
[in]	Bus	8-bit wide bus number.
[in]	Device	5-bit wide device number.
[in]	Function	3-bit wide function number.
[out]	PciDevice	The PCI_CAP_DEV object constructed as described above. PciDevice can be passed to the PciCapLib APIs.

Return values

RETURN_SUCCESS	PciDevice has been constructed and output.
RETURN_INVALID_PARAMETER	Device or Function does not fit in the permitted number of bits.
RETURN_OUT_OF_RESOURCES	Memory allocation failed.

Definition at line 177 of file BasePciCapPciSegmentLib.c.

PciCapPciSegmentDeviceUninit()

VOID EFIAPI PciCapPciSegmentDeviceUninit

(

IN PCI_CAP_DEV *

PciDevice

)

Free the resources used by PciDevice.

Parameters

[in]

PciDevice

The PCI_CAP_DEV object to free, originally produced by PciCapPciSegmentDeviceInit().

Definition at line 218 of file BasePciCapPciSegmentLib.c.