Skip to main content
PCI_EXPRESS_LINK_STATUS_REGISTER union

The PCI_EXPRESS_LINK_STATUS_REGISTER structure describes a PCI Express (PCIe) link status register of a PCIe capability structure.

Syntax


typedef union _PCI_EXPRESS_LINK_STATUS_REGISTER {
  struct {
    USHORT LinkSpeed  :4;
    USHORT LinkWidth  :6;
    USHORT Undefined  :1;
    USHORT LinkTraining  :1;
    USHORT SlotClockConfig  :1;
    USHORT DataLinkLayerActive  :1;
    USHORT Rsvd  :2;
  };
  USHORT AsUSHORT;
} PCI_EXPRESS_LINK_STATUS_REGISTER, *PPCI_EXPRESS_LINK_STATUS_REGISTER;

Members

LinkSpeed

The negotiated link speed of the PCIe link. Possible values are:

ValueDescription
12.5 gigabits per second.
25.0 gigabits per second.
All other valuesReserved.

 

LinkWidth

The negotiated link width (number of lanes) of the PCIe link. Possible values are:

ValueDescription
1x1 (1 lane)
2x2 (2 lanes)
4x4 (4 lanes)
8x8 (8 lanes)
12x12 (12 lanes)
16x16 (16 lanes)
32x32 (32 lanes)
All other valuesReserved.

 

Undefined

Reserved. Device drivers and other system software should ignore any value read from this bit.

LinkTraining

A single bit that indicates that the link is in the configuration or recovery state, or that a 1 was written to the retrain link bit of the PCIe link control register and the training has not yet begun. This member is not applicable to endpoint devices and upstream ports of switches.

SlotClockConfig

A single bit that indicates that the component uses the same physical reference clock that the hardware platform provides on the PCIe slot connector. If this bit is clear, the component uses an independent clock irrespective of the presence of a reference clock on the PCIe slot connector.

DataLinkLayerActive

A single bit that indicates that the data link control and management state machine is in the data link active state.

Rsvd

Reserved.

AsUSHORT

A USHORT representation of the contents of the PCI_EXPRESS_LINK_STATUS_REGISTER structure.

Remarks

The PCI_EXPRESS_LINK_STATUS_REGISTER structure is available in Windows Server 2008 and later versions of Windows.

A PCI_EXPRESS_LINK_STATUS_REGISTER structure is contained in the PCI_EXPRESS_CAPABILITY structure.

Requirements

Header

Ntddk.h (include Ntddk.h)

See also

PCI_EXPRESS_CAPABILITY

 

 

Send comments about this topic to Microsoft