Intel Extensible Firmware Interface Network Router User Manual


  Open as PDF
of 1084
 
Protocols PCI Bus Support
Version 1.10 12/01/02 12-35
EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.GetAttributes()
Summary
Gets the attributes that a PCI root bridge supports setting with SetAttributes(), and the
attributes that a PCI root bridge is currently using.
Prototype
typedef
EFI_STATUS
(EFIAPI *EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_GET_ATTRIBUTES) (
IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *This,
OUT UINT64 *Supports OPTIONAL,
OUT UINT64 *Attributes OPTIONAL
);
Parameters
This A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
Type EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL is defined in
Section 12.2.
Supports A pointer to the mask of attributes that this PCI root bridge
supports setting with SetAttributes(). The available
attributes are listed in Section 12.2. This is an optional parameter
that may be NULL.
Attributes A pointer to the mask of attributes that this PCI root bridge is
currently using. The available attributes are listed in Section 12.2.
This is an optional parameter that may be NULL.
Description
The GetAttributes() function returns the mask of attributes that this PCI root bridge supports
and the mask of attributes that the PCI root bridge is currently using. If Supports is not NULL,
then Supports is set to the mask of attributes that the PCI root bridge supports. If Attributes
is not NULL, then Attributes is set to the mask of attributes that the PCI root bridge is currently
using. If both Supports and Attributes are NULL, then EFI_INVALID_PARAMETER is
returned. Otherwise, EFI_SUCCESS is returned.
If a bit is set in Supports, then the PCI root bridge supports this attribute type, and a call can be
made to SetAttributes() using that attribute type. If a bit is set in Attributes, then the
PCI root bridge is currently using that attribute type. Since a PCI host bus may be composed of
more than one PCI root bridge, different Attributes values may be returned by different PCI
root bridges.