NDIS_LINK_STATE structure (ntddndis.h)

Article
08/07/2023

La structure NDIS_LINK_STATE spécifie l’état de liaison actuel d’un adaptateur miniport.

Syntaxe

typedef struct _NDIS_LINK_STATE {
  NDIS_OBJECT_HEADER             Header;
  NDIS_MEDIA_CONNECT_STATE       MediaConnectState;
  NDIS_MEDIA_DUPLEX_STATE        MediaDuplexState;
  ULONG64                        XmitLinkSpeed;
  ULONG64                        RcvLinkSpeed;
  NDIS_SUPPORTED_PAUSE_FUNCTIONS PauseFunctions;
  ULONG                          AutoNegotiationFlags;
} NDIS_LINK_STATE, *PNDIS_LINK_STATE;

Membres

Header

Structure NDIS_OBJECT_HEADER de la structure NDIS_LINK_STATE . Définissez le membre Type de la structure spécifiée par Header sur NDIS_OBJECT_TYPE_DEFAULT, le membre Revision sur NDIS_LINK_STATE_REVISION_1 et le membre Size sur NDIS_SIZEOF_LINK_STATE_REVISION_1.

MediaConnectState

État de connexion multimédia pour l’adaptateur miniport. Pour plus d'informations, consultez la rubrique
OID_GEN_MEDIA_CONNECT_STATUS_EX OID.

MediaDuplexState

État duplex multimédia de l’adaptateur miniport. Pour plus d’informations, consultez OID_GEN_MEDIA_DUPLEX_STATE OID.

XmitLinkSpeed

Vitesse de liaison de transmission actuelle de l’adaptateur miniport en bits par seconde. Pour plus d’informations, consultez OID_GEN_LINK_SPEED_EX.

Note La valeur NDIS_LINK_SPEED_UNKNOWN indique que la vitesse de la liaison de transmission est inconnue.

RcvLinkSpeed

Vitesse de liaison de réception actuelle de l’adaptateur miniport en bits par seconde. Pour plus d’informations, consultez OID_GEN_LINK_SPEED_EX.

Note La valeur NDIS_LINK_SPEED_UNKNOWN indique que la vitesse de la liaison de réception est inconnue.

PauseFunctions

Type de prise en charge des images de pause IEEE 802.3. Ce membre doit être l’une des fonctions de pause suivantes :

NdisPauseFunctionsUnsupported

l’adaptateur miniport ou le partenaire de liaison ne prend pas en charge les images de pause.

NdisPauseFunctionsSendOnly

l’adaptateur miniport et le partenaire de liaison prennent uniquement en charge l’envoi de trames de pause de l’adaptateur miniport au partenaire de liaison.

NdisPauseFunctionsReceiveOnly

l’adaptateur miniport et le partenaire de liaison prennent uniquement en charge l’envoi d’images de pause à partir du partenaire de liaison vers l’adaptateur miniport

NdisPauseFunctionsSendAndReceive

l’adaptateur miniport et le partenaire de liaison prennent en charge l’envoi et la réception de trames de pause dans les directions de transmission et de réception.

NdisPauseFunctionsUnknown

La négociation du cadre de pause est en cours. La prise en charge du frame de pause que fournit le partenaire de liaison est inconnue.

AutoNegotiationFlags

Paramètres de négociation automatique de l’adaptateur miniport. Ce membre est créé à partir d’un OR au niveau du bit des indicateurs suivants :

NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED

l’adaptateur miniport a négocié automatiquement la vitesse de la liaison de transmission avec le partenaire de liaison.

NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED

l’adaptateur miniport a négocié automatiquement la vitesse de la liaison de réception avec le partenaire de liaison.

NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED

l’adaptateur miniport a négocié automatiquement l’état duplex avec le partenaire de liaison.

NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED

l’adaptateur miniport a négocié automatiquement les fonctions de pause avec le partenaire de liaison.

Remarques

Les conducteurs de miniport utilisent la NDIS_STATUS_LINK_STATE status indication pour informer le NDIS et les conducteurs qui se superposent qu’il y a eu un changement dans les caractéristiques physiques d’un milieu.

Lorsqu’il génère cette indication status, le pilote définit le membre StatusBuffer de la structure NDIS_STATUS_INDICATION sur un pointeur vers une structure NDIS_LINK_STATE.

Le pilote miniport retourne également une structure NDIS_LINK_STATE lorsqu’il gère une requête de requête OID de OID_GEN_LINK_STATE.