NDIS_PORT_CHARACTERISTICS構造体 (ntddndis.h)
NDIS_PORT_CHARACTERISTICS 構造体は、NDIS ポートの特性を指定します。 NDIS ポートの詳細については、「NDIS ポートの を参照してください。
構文
typedef struct _NDIS_PORT_CHARACTERISTICS {
NDIS_OBJECT_HEADER Header;
NDIS_PORT_NUMBER PortNumber;
ULONG Flags;
NDIS_PORT_TYPE Type;
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;
} NDIS_PORT_CHARACTERISTICS, *PNDIS_PORT_CHARACTERISTICS;
メンバーズ
Header
NDIS_PORT_CHARACTERISTICS 構造体の NDIS_OBJECT_HEADER 構造体。 Header が指定 構造体の Type メンバーを NDIS_OBJECT_TYPE_DEFAULT、Revision メンバーを NDIS_PORT_CHARACTERISTICS_REVISION_1 に設定し、Size メンバーを NDIS_SIZEOF_PORT_CHARACTERISTICS_REVISION_1 に設定します。
PortNumber
この NDIS_PORT_CHARACTERISTICS 構造体に関連付けられている NDIS ポートの数。 PortNumber 値はNDIS_PORT_NUMBER値であり、ULONG データ型を持ち、0 から 0xffffff まで有効です。既定のポートでは 0 が予約されています。
Flags
ポート特性フラグのビットごとの OR の組み合わせ。フラグが設定されていない場合は 0。 現在、1 つのフラグがあります。
NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS フラグが設定されている場合、NDIS は認証状態の設定を無視し、代わりに既定の認証状態を使用します。 ミニポート ドライバーは、このフラグを使用して、NDIS が割り当ておよびアクティブ化するポートの既定の認証状態設定を使用するように要求できます。 ミニポート ドライバーが既定のポートを制御する場合、ミニポート ドライバーが既定のポートをアクティブ化するときに、ドライバーは既定の認証状態の設定で既定のポートをアクティブ化するNDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGSを設定できます。
Type
NDIS ポートの種類。 詳細については、NDIS ポートの のの種類を参照してください。 この型には、次のいずれかの値を指定できます。
NdisPortTypeUndefined
既定のポートの種類。
NdisPortTypeBridge
システム用に予約されています。
NdisPortTypeRasConnection
リモート アクセス サービス (RAS) 接続。
NdisPortType8021xSupplicant
このホスト コンピューター上のアクセス ポイントに関連付けられているリモート ワイヤレス ステーション。
NdisPortTypeNdisImPlatform
システム用に予約されています。
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
ポートが受信操作の制御された状態 (つまり、ポートには承認が必要) であり、SendAuthorizationState メンバーの値によって認証状態が決まります。
NdisPortControlStateUncontrolled
ポートは、受信操作の制御されていない状態です。 そのため、このポートには認証は適用されません。
SendAuthorizationState
送信操作のポートの承認状態。 SendControlState メンバーが NdisPortControlStateUncontrolled に設定されている場合は、このメンバーを無視します。
SendAuthorizationState には、次のいずれかの値が含まれている必要があります。
NdisPortAuthorizationUnknown
送信操作のポートの承認状態が不明です。
NdisPortAuthorized
ポートは送信操作に対して承認されています。
NdisPortUnauthorized
ポートは送信操作に対して承認されていません。
NdisPortReauthorizing
ポートは送信操作を再承認しています。
RcvAuthorizationState
受信操作のポートの承認状態。 RcvControlState メンバーが NdisPortControlStateUncontrolled に設定されている場合は、このメンバーを無視します。
RcvAuthorizationState には、次のいずれかの値が含まれている必要があります。
NdisPortAuthorizationUnknown
受信操作のポートの承認状態が不明です。
NdisPortAuthorized
ポートは受信操作に対して承認されています。
NdisPortUnauthorized
ポートは受信操作に対して承認されていません。
NdisPortReauthorizing
ポートは受信操作を再承認しています。
備考
NDIS_PORT_CHARACTERISTICS 構造体は、NDIS ポートの特性を指定します。 この構造体は、OID_GEN_ENUMERATE_PORTS OID で使用される NDIS_PORT_ARRAY 構造体で提供されるポート特性の一覧に表示されます。
NDIS ポートを割り当てるには、ドライバーは、NDIS_PORT_CHARACTERISTICS 構造体を初期化し、NdisMAllocatePort 関数に渡します。 NdisMAllocatePort 正常に返されると、NDIS は、NDIS_PORT_CHARACTERISTICS の PortNumber メンバーを、NDIS がポートに割り当てたポート番号に設定します。
NDIS は、ポート アクティブ化プラグ アンド プレイ (PnP) イベントのポートのリンクされた一覧を使用します。 NDIS では、NDIS_PORT 構造体を使用して、ポートのリンクされたリストを作成し、各 NDIS_PORT 構造体には NDIS_PORT_CHARACTERISTICS 構造体が含まれています。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | NDIS 6.0 以降でサポートされています。 |
| ヘッダー | ntddndis.h (Ndis.h を含む) |
関連項目
NdisMAllocatePort の
OID_GEN_MEDIA_CONNECT_STATUS_EX
NDIS ポートの の の種類