NDIS_LINK_STATE 構造体 (ntddndis.h)

[アーティクル]
08/07/2023

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 以降でサポートされています。
Header	ntddndis.h (Ndis.h を含む)

こちらもご覧ください

NDIS_OBJECT_HEADER

NDIS_STATUS_INDICATION

NDIS_STATUS_LINK_STATE

OID_GEN_LINK_SPEED_EX

OID_GEN_LINK_STATE

OID_GEN_MEDIA_CONNECT_STATUS_EX OID_GEN_MEDIA_DUPLEX_STATE

次の方法で共有