NDIS_PORT_CHARACTERISTICS 構造体 (ntddndis.h)

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

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

システムで使用するために予約されています。

メモこの値は、NDIS 6.30 以降でのみサポートされています。

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 構造体が含まれています。