NDIS_LINK_STATE structure (ntddndis.h)
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.
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.
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge dans NDIS 6.0 et versions ultérieures. |
| En-tête | ntddndis.h (include Ndis.h) |