Edit

MSFC_HBAPortAttributesResults structure (hbapiwmi.h)

  • Article

The structure is used by the GetDiscoveredPortAttributes WMI method to report the attributes for a specified remote fibre channel port.

Syntax

typedef struct _MSFC_HBAPortAttributesResults {
  UCHAR NodeWWN[8];
  UCHAR PortWWN[8];
  ULONG PortFcId;
  ULONG PortType;
  ULONG PortState;
  ULONG PortSupportedClassofService;
  UCHAR PortSupportedFc4Types[32];
  UCHAR PortActiveFc4Types[32];
  ULONG PortSupportedSpeed;
  ULONG PortSpeed;
  ULONG PortMaxFrameSize;
  UCHAR FabricName[8];
  ULONG NumberofDiscoveredPorts;
} MSFC_HBAPortAttributesResults, *PMSFC_HBAPortAttributesResults;

Members

NodeWWN[8]

Contains a 64 bit world-wide name (WWN) that uniquely identifies the fibre channel node associated with PortWWN. For a discussion of worldwide names, see the T11 committee's Fibre Channel HBA API specification.

PortWWN[8]

Contains a 64 bit world-wide name (WWN) that uniquely identifies the fibre channel port. For a discussion of worldwide names, see the T11 committee's Fibre Channel HBA API specification.

PortFcId

Contains the current fibre channel address of PortWWN. The high order byte of this member contains the first byte of the address, and successively lower order bytes of this member contain successively lower bytes of the address. The lowest order byte of this member must be zero.

PortType

Indicates the port type. This member must have one of the following values:

Value Meaning
HBA_PORTTYPE_UNKNOWN Unknown port type.
HBA_PORTTYPE_OTHER Value that is not a port type.
HBA_PORTTYPE_NOTPRESENT Port not present.
HBA_PORTTYPE_NPORT Fabric.
HBA_PORTTYPE_NLPORT Public loop.
HBA_PORTTYPE_FLPORT Fabric on a loop.
HBA_PORTTYPE_FPORT Fabric port.
HBA_PORTTYPE_EPORT Fabric expansion port.
HBA_PORTTYPE_GPORT Generic Fabric.
HBA_PORTTYPE_LPORT Private loop port.
HBA_PORTTYPE_PTP Point to point.

PortState

Contains the state of the port indicated by PortWWN. This member must have one of the following values:

Value Meaning
HBA_PORTSTATE_UNKNOWN Unknown.
HBA_PORTSTATE_ONLINE Operational.
HBA_PORTSTATE_OFFLINE User Offline
HBA_PORTSTATE_BYPASSED Bypassed.
HBA_PORTSTATE_DIAGNOSTICS In diagnostics mode.
HBA_PORTSTATE_LINKDOWN Link Down
HBA_PORTSTATE_ERROR Port Error.
HBA_PORTSTATE_LOOPBACK Loopback.

PortSupportedClassofService

Indicates the class of service that are supported by PortWWN. For a list of the differences classes of service and the values that must be assigned to this member for each class, see the ANSI standard for Fibre Channel Generic Services 4th Generation (FC-GS-4).

PortSupportedFc4Types[32]

Indicates the FC-4 types that are supported by PortWWN. For a discussion FC-4 types, see the ANSI standard for Fibre Channel Generic Services 4th Generation (FC-GS-4).

PortActiveFc4Types[32]

Indicates the FC-4 types that are currently available on PortWWN. For a discussion FC-4 types, see the ANSI standard for Fibre Channel Generic Services 4th Generation (FC-GS-4).

PortSupportedSpeed

Indicates the signaling bit rates at which PortWWN can operate. For a list of the values that this member supports, see PortSpeed.

PortSpeed

Indicates the signaling bit rates at which PortWWN is currently operating. This member must have one of the following values:

Value Meaning
HBA_PORTSPEED_UNKNOWN Speed unknown. The transceiver is incapable of reporting the speed.
HBA_PORTSPEED_1GBIT 1 gigabit per sec
HBA_PORTSPEED_2GBIT 2 gigabits per sec
HBA_PORTSPEED_4GBIT 4 gigabits per sec
HBA_PORTSPEED_10GBIT 10 gigabits per sec
HBA_PORTSPEED_NOT_NEGOTIATED The speed at which the port will operate has not yet been established.

PortMaxFrameSize

Indicates the maximum frame size, in bytes, that is supported by PortWWN.

FabricName[8]

Contains the name identifier for the fabric to which PortWWN is attached.

NumberofDiscoveredPorts

Indicates the number of ports that are visible to PortWWN. For a more detailed explanation of the sorts of ports that this number takes into consideration, see the T11 committee's specification for Fibre Channel HBA API (FC-HBA).

Requirements

Requirement Value
Header hbapiwmi.h (include Hbapiwmi.h, Hbaapi.h, Hbaapi.h)

See also

GetDiscoveredPortAttributes