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 値は、ULONG データ型を持ち、0 から0xffffffで有効なNDIS_PORT_NUMBER値です。既定のポート用に 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
NDIS ネットワーク インターフェイスの方向の種類 NET_IF_DIRECTION_TYPE 。
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 がポートに割り当てたポート番号にNDIS_PORT_CHARACTERISTICSの PortNumber メンバーを設定します。
NDIS では、ポートのアクティブ化プラグ アンド プレイ (PnP) イベントでポートのリンクされた一覧を使用します。 NDIS では 、NDIS_PORT 構造体を使用してポートのリンクリストを作成し、各 NDIS_PORT 構造体には NDIS_PORT_CHARACTERISTICS 構造体が含まれています。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | NDIS 6.0 以降でサポートされています。 |
| Header | ntddndis.h (Ndis.h を含む) |