5.4  FDDI Objects

This describes the mandatory OIDs for FDDI objects, both operational and statistical types.

FDDI Operational Characteristics

The following chart summarizes the mandatory OIDs used to get or set FDDI operational characteristics for NDIS drivers and NICs.

Length Q S Name
6 M OID_FDDI_LONG_PERMANENT_ADDR
Permanent station address
6 M OID_FDDI_LONG_CURRENT_ADDR
Current station address
Arr(6) M M OID_FDDI_LONG_MULTICAST_LIST
Multicast list
4 M OID_FDDI_LONG_MAX_LIST_SIZE
Maximum list size
2 M OID_FDDI_SHORT_PERMANENT_ADDR
Permanent station address
2 M OID_FDDI_SHORT_CURRENT_ADDR
Current station address
Arr(2) M M OID_FDDI_SHORT_MULTICAST_LIST
Multicast list
4 M OID_FDDI_SHORT_MAX_LIST_SIZE
Maximum list size

The following describes each of the OID_XXX listed in the preceding chart more fully.

OID_FDDI_LONG_PERMANENT_ADDR

The address of the NIC encoded in the hardware.

OID_FDDI_LONG_CURRENT_ADDR

The address the NIC is currently using.

The network management software cannot set the current station address using the NDIS interface library. It must set this address as a configuration parameter.

OID_FDDI_LONG_MULTICAST_LIST

The list of multicast addresses the NIC is currently using.

OID_FDDI_LONG_MAX_LIST_SIZE

The maximum size multicast list the NIC supports.

OID_FDDI_SHORT_PERMANENT_ADDR

The address of the NIC encoded in the hardware.

OID_FDDI_SHORT_CURRENT_ADDR

The address the NIC is currently using.

The network management software cannot set the current station address using the NDIS interface library. It must set this address as a configuration parameter.

OID_FDDI_SHORT_MULTICAST_LIST

The list of multicast addresses the NIC is currently using.

OID_FDDI_SHORT_MAX_LIST_SIZE

The maximum size multicast list the NIC supports.

FDDI Statistics

The following chart summarizes the mandatory OIDs used to get FDDI statistics from underlying NIC drivers (or from NDIS).

Length Q S Name
4 M OID_FDDI_ATTACHMENT_TYPE
The direction of traffic on the ring
6 M OID_FDDI_UPSTREAM_NODE_LONG
The long address of the station above this NIC on the ring
6 M OID_FDDI_DOWNSTREAM_NODE_LONG
The long address of the station below this NIC on the ring
4 M OID_FDDI_FRAME_ERRORS
The number of frames transmitted by this NIC that returned with errors
4 M OID_FDDI_FRAMES_LOST
The number of frames transmitted by this NIC that were not returned within an acceptable interval
4 M OID_FDDI_RING_MGT_STATE
The current state of the ring-management state machine.
4 M OID_FDDI_LCT_FAILURES
The number of times the link confidence test has failed during connection management.
4 M OID_FDDI_LEM_REJECTS
The link error monitor count of the times that a link was rejected.
4 M OID_FDDI_LCONNECTION_STATE
The state of this ports physical connection managment state machine.

The following describes each of the OID_XXX listed in the preceding chart more fully.

OID_FDDI_ATTACHMENT_TYPE

Defines the attachment of the NIC to the network as one of the following:

NdisFddiTypeIsolated
NdisFddiTypeLocalA
NdisFddiTypeLocalB
NdisFddiTypeLocalAB
NdisFddiTypeLocalS
NdisFddiTypeWrapA
NdisFddiTypeWrapB
NdisFddiTypeWrapAB
NdisFddiTypeWrapS
NdisFddiTypeCWrapA
NdisFddiTypeCWrapB
NdisFddiTypeCWrapS
NdisFddiTypeThrough

OID_FDDI_UPSTREAM_NODE_LONG

The long address of the station above this NIC on the ring or zero if the address is unknown.

In a dual-ring configuration, the upstream node is the station from which frames are passed to this station on the primary ring.

OID_FDDI_DOWNSTREAM_NODE_LONG

The long address of the station below this NIC on the ring or zero if the address is unknown. 

In a dual-ring configuration, the downstream node is the station to which frames are passed from this station on the primary ring.

OID_FDDI_FRAME_ERRORS

The number of frames detected in error by this NIC that have not been detected in error by another device on the ring.

OID_FDDI_FRAMES_LOST

The number of times this NIC detected a format error during frame reception such that the frame was stripped.

OID_FDDI_RING_MGT_STATE

Defines the current state of the Ring Management state machine as one of the following:

NdisFddiRingIsolated
NdisFddiRingNonOperational
NdisFddiRingOperational
NdisFddiRingDetect
NdisFddiRingNonOperationalDup
NdisFddiRingOperationalDup
NdisFddiRingDirected
NdisFddiRingTrace

OID_FDDI_LCT_FAILURES

The count of the consecutive times the link confidence test (LCT) has failed during connection management.

OID_FDDI_LEM_REJECTS

The link error monitor (LEM) count of times that a link was rejected.

OID_FDDI_LCONNECTION_STATE

Defines the state of this port’s Physical Connection Management (PCM) state machine as one of the following:

NdisFddiStateOff
NdisFddiStateBreak
NdisFddiStateTrace
NdisFddiStateConnect
NdisFddiStateNext
NdisFddiStateSignal
NdisFddiStateJoin
NdisFddiStateVerify
NdisFddiStateActive
NdisFddiStateMaintenance