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
ReceiveFilterCapabilities、PowerManagementCapabilitiesEx、および 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 がサポートされ、アダプターで有効になっている場合にのみ作成できます。
備考
NDIS は、BindParameters パラメーター内のNDIS_BIND_PARAMETERS構造体へのポインターを渡します。ProtocolBindAdapterEx 関数を します。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | NDIS 6.0 以降でサポートされています。 |
ヘッダー | ndis.h (Ndis.h を含む) |
関連項目
NDIS_RECEIVE_FILTER_CAPABILITIESOID_GEN_MEDIA_CONNECT_STATUS_EX
OID_GEN_RECEIVE_SCALE_CAPABILITIES