NDIS_PORT_STATE構造体 (ntddndis.h)
NDIS_PORT_STATE構造体は、NDIS ポートのポートの状態情報を指定します。
構文
typedef struct _NDIS_PORT_STATE {
NDIS_OBJECT_HEADER Header;
NDIS_MEDIA_CONNECT_STATE MediaConnectState;
ULONG64 XmitLinkSpeed;
ULONG64 RcvLinkSpeed;
NET_IF_DIRECTION_TYPE Direction;
NDIS_PORT_CONTROL_STATE SendControlState;
NDIS_PORT_CONTROL_STATE RcvControlState;
NDIS_PORT_AUTHORIZATION_STATE SendAuthorizationState;
NDIS_PORT_AUTHORIZATION_STATE RcvAuthorizationState;
ULONG Flags;
} NDIS_PORT_STATE, *PNDIS_PORT_STATE;
メンバーズ
Header
NDIS_PORT_STATE構造体の NDIS_OBJECT_HEADER 構造体。 Header が指定 構造体の Type メンバーを DEFAULT NDIS_OBJECT_TYPE_、Revision メンバーを NDIS_PORT_STATE_REVISION_1 に設定し、Size メンバーを NDIS_SIZEOF_PORT_STATE_REVISION_1 に設定します。
MediaConnectState
ポートのメディア接続状態。 この状態は、次の場合と同じ情報です。 OID_GEN_MEDIA_CONNECT_STATUS_EX OID が返されます。
XmitLinkSpeed
ポートの送信リンク速度 (ビット/秒)。 このメンバーの -1 値は、送信リンク速度が不明であることを示します。
RcvLinkSpeed
ポートの受信リンク速度 (ビット/秒)。 このメンバーの値 -1 は、受信リンク速度が不明であることを示します。
Direction
NET_IF_DIRECTION_TYPE NDIS ネットワーク インターフェイスの方向の種類。
SendControlState
送信操作のポートの現在の制御状態。 このメンバーには、次のいずれかの値が含まれている必要があります。
NdisPortControlStateUnknown
送信操作のポートの制御状態が不明です。
NdisPortControlStateControlled
ポートは、送信操作の制御された状態です。 つまり、ポートには承認が必要です。
NdisPortControlStateUncontrolled
ポートは、送信操作の制御されていない状態です。 つまり、ポートには承認は必要ありません。
RcvControlState
受信操作のポートの現在の制御状態。 このメンバーには、次のいずれかの値が含まれている必要があります。
NdisPortControlStateUnknown
受信操作のポートの制御状態が不明です。
NdisPortControlStateControlled
ポートは、受信操作の制御された状態です。 つまり、ポートには承認が必要です。
NdisPortControlStateUncontrolled
ポートは、受信操作の制御されていない状態です。 つまり、ポートには承認は必要ありません。
SendAuthorizationState
送信操作のポートの現在の承認状態。 SendControlState メンバーが NdisPortControlStateUncontrolled に設定されている場合は、このメンバーを無視します。
SendAuthorizationState には、次のいずれかの値が含まれている必要があります。
NdisPortAuthorizationUnknown
送信操作のポートの承認状態が不明です。
NdisPortAuthorized
ポートは送信操作に対して承認されています。
NdisPortUnauthorized
ポートは送信操作に対して承認されていません。
NdisPortReauthorizing
ポートは送信操作を再承認しています。
RcvAuthorizationState
受信操作のポートの現在の承認状態。 RcvControlState メンバーが NdisPortControlStateUncontrolled に設定されている場合は、このメンバーを無視します。
RcvAuthorizationState には、次のいずれかの値が含まれている必要があります。
NdisPortAuthorizationUnknown
受信操作のポートの承認状態が不明です。
NdisPortAuthorized
ポートは受信操作に対して承認されています。
NdisPortUnauthorized
ポートは受信操作に対して承認されていません。
NdisPortReauthorizing
ポートは受信操作を再承認しています。
Flags
NDIS 用に予約されています。
備考
NDIS_PORT_STATE構造体は、ポートの状態の変化を示すために NDIS_STATUS_PORT_STATE 状態表示で使用され、OID_GEN_PORT_STATE OID クエリに応答して使用されます。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | NDIS 6.0 以降でサポートされています。 |
| ヘッダー | ntddndis.h (Ndis.h を含む) |