NDIS_LINK_STATE-Struktur (ntddndis.h)

Artikel
02/26/2024

Die NDIS_LINK_STATE-Struktur gibt den aktuellen Verbindungsstatus eines Miniportadapters an.

Syntax

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;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die NDIS_LINK_STATE-Struktur . Legen Sie den Typmember der Struktur fest, die Header für NDIS_OBJECT_TYPE_DEFAULT, das Revisionselement auf NDIS_LINK_STATE_REVISION_1 und das Size-Element auf NDIS_SIZEOF_LINK_STATE_REVISION_1.

MediaConnectState

Der Medienverbindungsstatus für den Miniportadapter. Weitere Informationen finden Sie unter
OID_GEN_MEDIA_CONNECT_STATUS_EX OID.

MediaDuplexState

Der Medienduplexzustand für den Miniportadapter. Weitere Informationen finden Sie unter OID_GEN_MEDIA_DUPLEX_STATE OID.

XmitLinkSpeed

Die aktuelle Übertragungsverbindungsgeschwindigkeit des Miniportadapters in Bits pro Sekunde. Weitere Informationen finden Sie unter OID_GEN_LINK_SPEED_EX.

Hinweis Der Wert NDIS_LINK_SPEED_UNKNOWN gibt an, dass die Übertragungsverbindungsgeschwindigkeit unbekannt ist.

RcvLinkSpeed

Die aktuelle Empfangslinkgeschwindigkeit des Miniportadapters in Bits pro Sekunde. Weitere Informationen finden Sie unter OID_GEN_LINK_SPEED_EX.

Hinweis Der Wert NDIS_LINK_SPEED_UNKNOWN gibt an, dass die Geschwindigkeit des Empfangslinks unbekannt ist.

PauseFunctions

Die Art der Unterstützung für die IEEE 802.3-Pauseframes. Dieser Member muss eine der folgenden Pausenfunktionen sein:

NdisPauseFunctionsUnsupported

Der Miniportadapter oder Linkpartner unterstützt keine Pauseframes.

NdisPauseFunctionsSendOnly

der Miniportadapter und der Linkpartner unterstützen nur das Senden von Pauseframes vom Miniportadapter an den Linkpartner.

NdisPauseFunctionsReceiveOnly

Der Miniportadapter und der Linkpartner unterstützen nur das Senden von Pauseframes vom Linkpartner an den Miniportadapter.

NdisPauseFunctionsSendAndReceive

Der Miniportadapter und der Linkpartner unterstützen das Senden und Empfangen von Pauseframes sowohl in Übertragungs- als auch in Empfangsanweisungen.

NdisPauseFunctionsUnknown

Die Aushandlung des Pauseframes wird ausgeführt. Die Unterstützung des Pauseframes, die der Linkpartner bereitstellt, ist unbekannt.

AutoNegotiationFlags

Die Einstellungen für die automatische Aushandlung für den Miniportadapter. Dieser Member wird aus einem bitweisen OR der folgenden Flags erstellt:

NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED

Der Miniportadapter hat die Übertragungsverbindungsgeschwindigkeit automatisch mit dem Linkpartner ausgehandelt.

NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED

Der Miniportadapter hat die Empfangslinkgeschwindigkeit automatisch mit dem Linkpartner ausgehandelt.

NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED

Der Miniportadapter hat den Duplexzustand automatisch mit dem Linkpartner ausgehandelt.

NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED

Der Miniportadapter hat die Pausenfunktionen automatisch mit dem Linkpartner ausgehandelt.

Hinweise

Miniport-Treiber verwenden die NDIS_STATUS_LINK_STATE status Anzeige, um NDIS und übersteigende Treiber darüber zu informieren, dass sich die physischen Eigenschaften eines Mediums geändert haben.

Wenn diese status-Anzeige generiert wird, legt der Treiber den StatusBuffer-Member der NDIS_STATUS_INDICATION-Struktur auf einen Zeiger auf eine NDIS_LINK_STATE-Struktur fest.

Der Miniporttreiber gibt auch eine NDIS_LINK_STATE-Struktur zurück, wenn er eine OID-Abfrageanforderung von OID_GEN_LINK_STATE verarbeitet.