OID_GEN_LINK_PARAMETERS
セットとして、NDIS と上にあるドライバーは OID_GEN_LINK_PARAMETERS OID を使用し、ミニポート アダプターの現在のリンク状態を設定します。 ミニポート ドライバーは、双方向の状態、リンク速度、および NDIS_LINK_PARAMETERS 構造体の一時停止機能を受け取ります。
バージョン情報
Windows Vista 以降のバージョンの Windows
サポート対象。
NDIS_LINK_PARAMETERS 構造体は次のように定義されます。
typedef struct _NDIS_LINK_PARAMETERS {
NDIS_OBJECT_HEADER Header;
NDIS_MEDIA_DUPLEX_STATE MediaDuplexState;
ULONG64 XmitLinkSpeed;
ULONG64 RcvLinkSpeed;
NDIS_SUPPORTED_PAUSE_FUNCTIONS PauseFunctions;
ULONG AutoNegotiationFlags;
} NDIS_LINK_PARAMETERS, *PNDIS_LINK_PARAMETERS;
この構造体には次のメンバーが含まれます。
ヘッダー
NDIS_LINK_PARAMETERS 構造体の NDIS_OBJECT_HEADER 構造体。 Header が指定する構造体の Type メンバーを NDIS_OBJECT_TYPE_DEFAULT に、Revision メンバーを NDIS_LINK_PARAMETERS_REVISION_1 に、Size メンバーを NDIS_SIZEOF_LINK_PARAMETERS_REVISION_1 に設定します。
MediaDuplexState
メディアのデュプレックス状態。 この値は OID_GEN_MEDIA_DUPLEX_STATE OID によって返される値と同じです。
XmitLinkSpeed
1 秒あたりの送信リンク速度 (ビット単位)。
RcvLinkSpeed
1 秒あたりの受信リンク速度 (ビット単位)。
PauseFunctions
IEEE 802.3 の一時停止フレームのサポートの種類。 このメンバーは、次のいずれかの一時停止関数である必要があります。
NdisPauseFunctionsUnsupported
アダプターまたはリンク パートナーは、一時停止フレームをサポートしていません。
NdisPauseFunctionsSendOnly
アダプターとリンク パートナーは、アダプターからリンク パートナーへの一時停止フレームの送信のみをサポートします。
NdisPauseFunctionsReceiveOnly
アダプターとリンク パートナーは、リンク パートナーからアダプターへの一時停止フレームの送信のみをサポートします。
NdisPauseFunctionsSendAndReceive
アダプターとリンク パートナーは、送信方向と受信方向の両方で一時停止フレームの送受信をサポートします。
AutoNegotiationFlags
ミニポート アダプターの自動ネゴシエーション設定。 このメンバーは、次のフラグのビットごとの OR から作成されます。
NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED
アダプターは、送信リンク速度をリンク パートナーと自動ネゴシエートする必要があります。 このフラグが設定されていない場合、ミニポート ドライバーは、XmitLinkSpeed メンバーで指定されている値に送信リンク速度を設定する必要があります。
NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED
アダプターは、受信リンク速度をリンク パートナーと自動ネゴシエートする必要があります。 このフラグが設定されていない場合、ミニポート ドライバーは、XmitLinkSpeed メンバーで指定されている値に受信リンク速度を設定する必要があります。
NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED
アダプターは、デュプレックス状態をリンク パートナーと自動ネゴシエートする必要があります。 このフラグが設定されていない場合、ミニポート ドライバーは、MediaDuplexState メンバーで指定されている値にデュプレックス状態を設定する必要があります。
NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED
ミニポート ドライバーは、もう一方の端と一時停止フレームのサポートを自動ネゴシエートする必要があります。 このフラグが設定されていない場合、ミニポート ドライバーは、PauseFunctions メンバーで指定されている一時停止フレームのサポートを使用する必要があります。
解説
注 OID_GEN_LINK_PARAMETERS を設定すると、接続が失われる可能性があります。 ミニポート ドライバーは、この OID が設定されている場合、ミニポート アダプターを再構成する必要があります。 たとえば、ミニポート ドライバーは、既存の接続が失われたミニポート アダプターをリセットできます。 再構成の具体的なメカニズムは、アプリケーションによって異なります。
OID_GEN_LINK_PARAMETERSセット要求が原因でミニポート アダプターのリンクの状態が変更された場合、ミニポート ドライバーは、NDIS_STATUS_LINK_STATE 状態の表示を新しいリンク状態の NDIS と上にあるドライバーに通知する必要があります。
要件
ヘッダー |
Ntddndis.h (Ndis.h を含む) |