次の方法で共有


NDIS_BIND_PARAMETERS構造体 (ndis.h)

NDIS は、バインディングの特性を定義し、プロトコル ドライバーに渡す情報を使用して、NDIS_BIND_PARAMETERS 構造体を初期化します。

構文

typedef struct _NDIS_BIND_PARAMETERS {
  NDIS_OBJECT_HEADER                Header;
  PNDIS_STRING                      ProtocolSection;
  PNDIS_STRING                      AdapterName;
  PDEVICE_OBJECT                    PhysicalDeviceObject;
  NDIS_MEDIUM                       MediaType;
  ULONG                             MtuSize;
  ULONG64                           MaxXmitLinkSpeed;
  ULONG64                           XmitLinkSpeed;
  ULONG64                           MaxRcvLinkSpeed;
  ULONG64                           RcvLinkSpeed;
  NDIS_MEDIA_CONNECT_STATE          MediaConnectState;
  NDIS_MEDIA_DUPLEX_STATE           MediaDuplexState;
  ULONG                             LookaheadSize;
  PNDIS_PNP_CAPABILITIES            PowerManagementCapabilities;
  ULONG                             SupportedPacketFilters;
  ULONG                             MaxMulticastListSize;
  USHORT                            MacAddressLength;
  UCHAR                             CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  NDIS_PHYSICAL_MEDIUM              PhysicalMediumType;
  PNDIS_RECEIVE_SCALE_CAPABILITIES  RcvScaleCapabilities;
  NET_LUID                          BoundIfNetluid;
  NET_IFINDEX                       BoundIfIndex;
  NET_LUID                          LowestIfNetluid;
  NET_IFINDEX                       LowestIfIndex;
  NET_IF_ACCESS_TYPE                AccessType;
  NET_IF_DIRECTION_TYPE             DirectionType;
  NET_IF_CONNECTION_TYPE            ConnectionType;
  NET_IFTYPE                        IfType;
  BOOLEAN                           IfConnectorPresent;
  PNDIS_PORT                        ActivePorts;
  ULONG                             DataBackFillSize;
  ULONG                             ContextBackFillSize;
  ULONG                             MacOptions;
  NET_IF_COMPARTMENT_ID             CompartmentId;
  PNDIS_OFFLOAD                     DefaultOffloadConfiguration;
  PNDIS_TCP_CONNECTION_OFFLOAD      TcpConnectionOffloadCapabilities;
  PNDIS_STRING                      BoundAdapterName;
  PNDIS_HD_SPLIT_CURRENT_CONFIG     HDSplitCurrentConfig;
  PNDIS_RECEIVE_FILTER_CAPABILITIES ReceiveFilterCapabilities;
  PNDIS_PM_CAPABILITIES             PowerManagementCapabilitiesEx;
  PNDIS_NIC_SWITCH_CAPABILITIES     NicSwitchCapabilities;
  BOOLEAN                           NDKEnabled;
  PNDIS_NDK_CAPABILITIES            NDKCapabilities;
  PNDIS_SRIOV_CAPABILITIES          SriovCapabilities;
  PNDIS_NIC_SWITCH_INFO_ARRAY       NicSwitchArray;
} NDIS_BIND_PARAMETERS, *PNDIS_BIND_PARAMETERS;

メンバーズ

Header

NDIS_BIND_PARAMETERS 構造体の NDIS_OBJECT_HEADER 構造体。 NDIS ヘッダー がNDIS_OBJECT_TYPE_BIND_PARAMETERSに指定 構造体の メンバーを設定します。

NDIS_BIND_PARAMETERS構造体のバージョンを示すために、NDIS は、リビジョン メンバーを次のいずれかの値に設定します。

NDIS_BIND_PARAMETERS_REVISION_4

NDIS 6.30 のさまざまなメンバーを追加しました。

NDIS は、サイズ メンバーをNDIS_SIZEOF_BIND_PARAMETERS_REVISION_4に設定します。

NDIS_BIND_PARAMETERS_REVISION_3

ReceiveFilterCapabilitiesPowerManagementCapabilitiesEx、および NDIS 6.20 の NicSwitchCapabilities メンバー 追加しました。

NDIS は、サイズ メンバーをNDIS_SIZEOF_BIND_PARAMETERS_REVISION_3に設定します。

NDIS_BIND_PARAMETERS_REVISION_2

NDIS 6.1 HDSplitCurrentConfig メンバーを追加しました。

NDIS サイズ メンバーをNDIS_SIZEOF_BIND_PARAMETERS_REVISION_2に設定します。

NDIS_BIND_PARAMETERS_REVISION_1

NDIS 6.0 の元のバージョン。

NDIS は、サイズ メンバーをNDIS_SIZEOF_BIND_PARAMETERS_REVISION_1に設定します。

ProtocolSection

レジストリ パスを含む Unicode 文字列へのポインター。 このパスは、プロトコル ドライバーのサービス キーから始まり、レジストリ階層をミニポート アダプター名 (たとえば、tcpip\Parameters\Adapters\ <ミニポート アダプター名>) まで継続します。 ミニポート アダプター名は、ドライバー スタックで最も下位のミニポート アダプターの名前です。 スタックに MUX 中間ドライバーがある場合、最下位のミニポート アダプターは仮想ミニポートです。 それ以外の場合、最下位のミニポート アダプターは、物理デバイスのミニポート アダプターです。

プロトコル ドライバーは、このレジストリ パスを使用して、ドライバーと基になるミニポート アダプター間のバインドに固有の構成パラメーターを読み取ることができます。

AdapterName

ProtocolBindAdapterEx バインドする基になるミニポート アダプターの名前 含む Unicode 文字列へのポインター。

PhysicalDeviceObject

基になるミニポート アダプターの物理デバイス オブジェクト。

MediaType

NdisMediumXxx 基になるミニポート アダプターがサポートする型です。 NdisMedium Xxx 型のの詳細については、NDIS_MEDIUMを参照してください。

MtuSize

最大転送単位 (MTU) サイズ。 詳細については、OID_GEN_MAXIMUM_FRAME_SIZEを参照してください。

MaxXmitLinkSpeed

基になるアダプターの最大送信リンク速度 (ビット/秒)。 詳細については、OID_GEN_MAX_LINK_SPEEDを参照してください。

XmitLinkSpeed

基になるアダプターの現在の送信リンク速度 (ビット/秒)。 詳細については、OID_GEN_LINK_SPEED_EXを参照してください。

MaxRcvLinkSpeed

基になるアダプターの最大受信リンク速度 (ビット/秒)。 詳細については、OID_GEN_MAX_LINK_SPEEDを参照してください。

RcvLinkSpeed

基になるアダプターの現在の受信リンク速度 (ビット/秒)。 詳細については、OID_GEN_LINK_SPEED_EXを参照してください。

MediaConnectState

基になるミニポート アダプターのメディア接続状態。 詳細については、次を参照してください。 OID_GEN_MEDIA_CONNECT_STATUS_EX.

MediaDuplexState

基になるミニポート アダプターのメディア二重状態。 詳細については、OID_GEN_MEDIA_DUPLEX_STATEを参照してください。

LookaheadSize

基になるミニポート アダプターの先読みサイズ。 詳細については、OID_GEN_CURRENT_LOOKAHEADを参照してください。

PowerManagementCapabilities

基になるミニポート アダプターのプラグ アンド プレイ機能。 詳細については、OID_PNP_CAPABILITIESを参照してください。 NDIS 6.20 以降のドライバーは、代わりに PowerManagementCapabilitiesEx メンバーを使用する必要があります。

SupportedPacketFilters

基になるミニポート アダプターがフィルター処理できるネットワーク パケットの種類を識別するフラグのセット。

MaxMulticastListSize

基になるミニポート アダプターのマルチキャスト アドレス一覧のサイズ。 詳細については、次を参照してください。 OID_802_3_MAXIMUM_LIST_SIZE.

MacAddressLength

MAC アドレスの長さ (バイト単位)。 MAC アドレスの長さは、メディアの種類に固有です。

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

現在の MAC アドレス。 たとえば、OID_802_3_CURRENT_ADDRESS OID は、IEEE 802.3 ドライバーの現在の MAC アドレスを指定します。

PhysicalMediumType

ミニポート アダプターの物理メディアの種類。 詳細については、OID_GEN_PHYSICAL_MEDIUMを参照してください。

RcvScaleCapabilities

は、NIC のサイド スケーリング (RSS) 機能を受け取ります。 詳細については、次を参照してください。 OID_GEN_RECEIVE_SCALE_CAPABILITIES.

BoundIfNetluid

NDIS NET_LUID 値。つまり、ミニポート アダプターにスタックされている最上位レベルのインターフェイスのネットワーク インターフェイス名 (RFC 2863 の ifName )。 つまり、ミニポート アダプター経由でインストールされている仮想ミニポートまたはフィルター モジュールがある場合、これは最上位レベルの仮想ミニポートまたはフィルター モジュールのNET_LUID値です。

BoundIfIndex

ミニポート アダプターに積み重ねられた最上位レベルのインターフェイスの NDIS ネットワーク インターフェイス インデックス。 つまり、ミニポート アダプター経由でインストールされている仮想ミニポートまたはフィルター モジュールがある場合、これは最上位レベルの仮想ミニポートまたはフィルター モジュールの ifIndex です。

LowestIfNetluid

NDIS NET_LUID 値。これは、バインディングの最下位レベルのインターフェイスのネットワーク インターフェイス名 (RFC 2863 の ifName ) でもあります。 つまり、フィルター スタックの下部にあるミニポート アダプターの NDIS ネットワーク インターフェイスです。

LowestIfIndex

バインディング上の最下位レベルのインターフェイスの NDIS ネットワーク インターフェイス インデックス。 つまり、フィルター スタックの下部にあるミニポート アダプターの NDIS ネットワーク インターフェイスです。

AccessType

NET_IF_ACCESS_TYPE NDIS ネットワーク インターフェイス アクセスの種類。

DirectionType

NET_IF_DIRECTION_TYPE NDIS ネットワーク インターフェイスの方向の種類。

ConnectionType

NDIS ネットワーク インターフェイスの接続の種類。 一般的なイーサネット アダプターには NET_IF_CONNECTION_DEDICATED を使用します。 次の値が有効です。

NET_IF_CONNECTION_DEDICATED

専用接続の種類を指定します。 メディア センスが TRUE 場合、接続が自動的に起動します。 たとえば、イーサネット接続は専用です。

NET_IF_CONNECTION_PASSIVE

パッシブ接続の種類を指定します。 もう一方の端は、ローカル ステーションへの接続を起動する必要があります。 たとえば、RAS インターフェイスはパッシブです。

NET_IF_CONNECTION_DEMAND

デマンド ダイヤル接続の種類を指定します。 要求ダイヤル接続は、ローカル アクション (パケットの送信など) に応答して起動します。

IfType

インターネット割り当て番号機関 (IANA) インターフェイスの種類。 たとえば、IF_TYPE_ETHERNET_CSMACD (6) は、イーサネットに似たインターフェイスに割り当てられている IfType の値です。 インターフェイスの種類の一覧については、「NDIS インターフェイスの種類を参照してください。

IfConnectorPresent

コネクタが存在するかどうかを示すブール値。 NDIS は、物理アダプターがある場合、この値を TRUE 設定します。

ActivePorts

決定されます。

DataBackFillSize

基になるドライバー スタックの必要なデータ バックフィル サイズ (バイト単位)。

ContextBackFillSize

基になるドライバー スタックの必要なコンテキスト バックフィル サイズ (バイト単位)。

MacOptions

ミニポート アダプターの MAC オプション。 詳細については、OID_GEN_MAC_OPTIONSを参照してください。

CompartmentId

基になるインターフェイスが属するコンパートメント、または次のいずれかの値。

NET_IF_COMPARTMENT_ID_UNSPECIFIED

コンパートメント識別子が使用または指定されていないことを指定します。

NET_IF_COMPARTMENT_ID_PRIMARY

既定のコンパートメント識別子を指定します。 サード パーティのインターフェイス プロバイダーは、常にNET_IF_COMPARTMENT_ID_PRIMARYを指定する必要があります。 その他の値はすべて、Microsoft 内部で使用するために予約されています。

DefaultOffloadConfiguration

NDIS_OFFLOAD 構造体へのポインター。 この構造体は、タスク オフロード対応ミニポート アダプターの機能を指定します。 詳細については、次を参照してください。 OID_TCP_OFFLOAD_CURRENT_CONFIG.

TcpConnectionOffloadCapabilities

へのポインター基になるミニポート アダプターによって提供される現在のオフロード機能を示す NDIS_TCP_CONNECTION_OFFLOAD 構造体。

BoundAdapterName

基になるミニポート アダプターに積み重ねられた最上位レベルのミニポート アダプターの名前を含む Unicode 文字列へのポインター。 つまり、ミニポート アダプター経由でインストールされているフィルター中間ドライバー仮想ミニポートがある場合、このメンバーは、最上位レベルのフィルター中間ドライバーの仮想ミニポートの名前です。

HDSplitCurrentConfig

へのポインター NDIS_HD_SPLIT_CURRENT_CONFIG 構造体。 この構造体は、基になるミニポート アダプターの現在のヘッダー データ分割構成を指定します。 ミニポート アダプターがヘッダー データ分割をサポートしていない場合、この値は NULL できます。

ReceiveFilterCapabilities

へのポインター NDIS_RECEIVE_FILTER_CAPABILITIES 構造体。 この構造体は、基になるミニポート アダプターで現在有効になっている汎用フィルター機能を指定します。 ミニポート アダプターが受信フィルター処理をサポートしていない場合、この値は NULL できます。

PowerManagementCapabilitiesEx

NDIS_PM_CAPABILITIES 構造体へのポインター。 この構造体は、ミニポート アダプターの電源管理機能を指定します。 このメンバーは、NDIS 6.20 以降のドライバーに必須です。

NicSwitchCapabilities

へのポインター NDIS_NIC_SWITCH_CAPABILITIES 構造体。 この構造体は、基になるミニポート アダプターの NIC スイッチ機能を指定します。 ミニポート アダプターが NIC スイッチ機能をサポートしていない場合、この値は NULL できます。

NDKEnabled

NDIS は、ネットワーク ダイレクト カーネル プロバイダー インターフェイス (NDKPI) が基になるミニポート アダプターで現在有効になっている場合、この値を TRUE に設定します。

NDKCapabilities

NDIS_NDK_CAPABILITIES 構造体へのポインター。 この構造体は、基になるミニポート アダプターで現在有効になっている NDKPI 機能を指定します。 ミニポート アダプターが NDKPI をサポートしていない場合、この値は NULL できます。

SriovCapabilities

NDIS_SRIOV_CAPABILITIES 構造体へのポインター。 この構造体は、基になるミニポート アダプターで現在有効になっている単一ルート I/O 仮想化 (SR-IOV) 機能を指定します。 ミニポート アダプターが SR-IOV 機能をサポートしていない場合、この値は NULL できます。

NicSwitchArray

NDIS_NIC_SWITCH_INFO_ARRAY 構造体へのポインター。 この配列は、ミニポート アダプターで作成された NIC スイッチを列挙します。 NIC スイッチは、SR-IOV がサポートされ、アダプターで有効になっている場合にのみ作成できます。

Windows Server 2012 以降では、ミニポート アダプターの既定の NIC スイッチのみがサポートされます。 そのため、この配列には要素を 1 つだけ含めることができます。
 

備考

NDIS は、BindParameters パラメーター内のNDIS_BIND_PARAMETERS構造体へのポインターを渡します。ProtocolBindAdapterEx 関数を します。

必要条件

要件 価値
サポートされる最小クライアント NDIS 6.0 以降でサポートされています。
ヘッダー ndis.h (Ndis.h を含む)

関連項目

NDIS_HD_SPLIT_CURRENT_CONFIG

NDIS_MEDIUM

NDIS_NIC_SWITCH_CAPABILITIES

NDIS_NIC_SWITCH_INFO_ARRAY

NDIS_OBJECT_HEADER

NDIS_OFFLOAD

NDIS_PM_CAPABILITIES

NDIS_RECEIVE_FILTER_CAPABILITIES

NDIS_SRIOV_CAPABILITIES

NDIS_TCP_CONNECTION_OFFLOAD

NET_IF_ACCESS_TYPE

NET_IF_DIRECTION_TYPE

NET_LUID

OID_802_3_CURRENT_ADDRESS

OID_802_3_MAXIMUM_LIST_SIZE

OID_802_3_PERMANENT_ADDRESS

OID_GEN_CURRENT_LOOKAHEAD

OID_GEN_LINK_SPEED_EX

OID_GEN_MAC_OPTIONS

OID_GEN_MAXIMUM_FRAME_SIZE

OID_GEN_MAX_LINK_SPEED

OID_GEN_MEDIA_CONNECT_STATUS_EX

OID_GEN_MEDIA_DUPLEX_STATE

OID_GEN_PHYSICAL_MEDIUM

OID_GEN_RECEIVE_SCALE_CAPABILITIES

OID_PNP_CAPABILITIES

OID_TCP_OFFLOAD_CURRENT_CONFIG

ProtocolBindAdapterEx