NDIS_STATUS_LINK_STATE (Compact 2013)
3/26/2014
Miniport drivers use this status indication to notify NDIS and overlying drivers that there has been a change in the physical characteristics of a medium.
Remarks
Overlying drivers should not use the OID_GEN_LINK_STATE OID to determine the link state. Instead, use the NDIS_STATUS_LINK_STATE status indication for link state updates.
The StatusBuffer member of the NDIS_STATUS_INDICATION structure contains the NDIS_LINK_STATE structure. This structure specifies the physical state of the medium.
Miniport drivers should avoid sending the NDIS_STATUS_LINK_STATUS status indication if there have been no changes in the physical state of the medium. However, avoiding this status indication is not a requirement.
If a miniport adapter transitions to a low power state, NDIS 6.0 miniport drivers should indicate a connection status of MediaConnectStateUnknown. When the miniport adapter transitions back to the working power state, the miniport driver should indicate a status of MediaConnectStateConnected after the link has been reestablished.
NDIS might not pass a status indication to overlying drivers if there are no changes in the link state as specified in the previously indicated link state. However, this behavior is not guaranteed. Overlying drivers that receive this status indication must determine which characteristics of the medium, if any, have changed.
If an overlying driver is an NDIS 5.x or earlier protocol driver, NDIS translates the NDIS_STATUS_LINK_STATE status indication to appropriate NDIS 5.1 status indications. NDIS indicates link speed changes with the NDIS_STATUS_LINK_SPEED_CHANGE status indication. NDIS indicates changes in the connection state with NDIS_STATUS_MEDIA_CONNECT and NDIS_STATUS_MEDIA_DISCONNECT status indications.
NDIS also translates the NDIS 5.x miniport driver status for overlying NDIS 6.0 drivers. NDIS uses status indications or media state changes that NDIS identified in an NDIS 5.x OID query to create NDIS_STATUS_LINK_STATE status indications. NDIS performs the following translations:
- The NDIS_STATUS_MEDIA_CONNECT status indication is translated to MediaConnectStateConnected in the NDIS_LINK_STATE structure.
- The NDIS_STATUS_MEDIA_DISCONNECT status indication is translated to MediaConnectStateDisconnected in the NDIS_LINK_STATE structure.
- The NDIS_STATUS_LINK_SPEED_CHANGE status indication and the OID_GEN_LINK_SPEED OID are used to generate the link speed status.
- For more information about link status, see OID_GEN_LINK_STATE.
Requirements
Header |
ndis.h |
See Also
Reference
NDIS General Status Indications
NDIS_STATUS_INDICATION
NDIS_STATUS_LINK_SPEED_CHANGE
NDIS_STATUS_MEDIA_CONNECT
NDIS_STATUS_MEDIA_DISCONNECT
OID_GEN_LINK_SPEED
OID_GEN_LINK_STATE