NDIS_LINK_STATE構造体 (ntddndis.h)

[アーティクル]
02/07/2025

NDIS_LINK_STATE 構造体は、ミニポートアダプターの現在のリンク状態を指定します。

構文

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;

メンバーズ

Header

NDIS_LINK_STATE 構造体の NDIS_OBJECT_HEADER 構造体。 Header が指定 構造体の Type メンバーを NDIS_OBJECT_TYPE_DEFAULT、Revision メンバーを NDIS_LINK_STATE_REVISION_1 に設定し、Size メンバーを NDIS_SIZEOF_LINK_STATE_REVISION_1 に設定します。

MediaConnectState

ミニポートアダプターのメディア接続状態。詳細については、次を参照してください。
OID_GEN_MEDIA_CONNECT_STATUS_EX OID。

MediaDuplexState

ミニポートアダプターのメディア二重状態。詳細については、「 OID_GEN_MEDIA_DUPLEX_STATE OID」を参照してください。

XmitLinkSpeed

ミニポートアダプターの現在の送信リンク速度 (ビット/秒)。詳細については、OID_GEN_LINK_SPEED_EXを参照してください。

注 NDIS_LINK_SPEED_UNKNOWN の値は、送信リンク速度が不明であることを示します。

RcvLinkSpeed

ミニポートアダプターの現在の受信リンク速度 (ビット/秒)。詳細については、OID_GEN_LINK_SPEED_EXを参照してください。

注 NDIS_LINK_SPEED_UNKNOWN の値は、受信リンク速度が不明であることを示します。

PauseFunctions

IEEE 802.3 の一時停止フレームのサポートの種類。このメンバーは、次のいずれかの一時停止関数である必要があります。

NdisPauseFunctionsUnsupported

ミニポートアダプターまたはリンクパートナーは、一時停止フレームをサポートしていません。

NdisPauseFunctionsSendOnly

ミニポートアダプターとリンクパートナーは、ミニポートアダプターからリンクパートナーへの一時停止フレームの送信のみをサポートします。

NdisPauseFunctionsReceiveOnly

ミニポートアダプターとリンクパートナーは、リンクパートナーからミニポートアダプターへの一時停止フレームの送信のみをサポートします

NdisPauseFunctionsSendAndReceive

ミニポートアダプターとリンクパートナーは、送信方向と受信方向の両方で一時停止フレームの送受信をサポートします。

NdisPauseFunctionsUnknown

フレームネゴシエーションの一時停止が進行中です。リンクパートナーが提供する一時停止フレームのサポートは不明です。

AutoNegotiationFlags

ミニポートアダプターの自動ネゴシエーション設定。このメンバーは、次のフラグのビットごとの OR から作成されます。

NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED

ミニポートアダプターは、リンクパートナーとの送信リンク速度を自動的にネゴシエートしています。

NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED

ミニポートアダプターは、リンクパートナーとの受信リンク速度を自動的にネゴシエートしています。

NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED

ミニポートアダプターは、リンクパートナーと双方向状態を自動的にネゴシエートします。

NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED

ミニポートアダプターは、リンクパートナーとの一時停止機能を自動的にネゴシエートしています。

備考

ミニポートドライバーは、NDIS_STATUS_LINK_STATE 状態の表示を使用して、中の物理的な特性に変更があったことを NDIS と上にあるドライバーに通知します。

この状態表示が生成されると、ドライバーは、NDIS_STATUS_INDICATION 構造体の StatusBuffer メンバーを NDIS_LINK_STATE 構造体へのポインターに設定します。

ミニポートドライバーは、OID_GEN_LINK_STATEの OID クエリ要求を処理するときにも、NDIS_LINK_STATE 構造体を返します。

必要条件

要件	価値
サポートされる最小クライアント	NDIS 6.0 以降でサポートされています。
ヘッダー	ntddndis.h (Ndis.h を含む)

次の方法で共有