NDIS_BIND_PARAMETERS 结构 (ndis.h)

项目
04/13/2023

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 将 Header 指定的结构的 Type 成员设置为 NDIS_OBJECT_TYPE_BIND_PARAMETERS。

为了指示NDIS_BIND_PARAMETERS结构的版本，NDIS 将 Revision 成员设置为以下值之一：

NDIS_BIND_PARAMETERS_REVISION_4

为 NDIS 6.30 添加了各种成员。

NDIS 将 Size 成员设置为 NDIS_SIZEOF_BIND_PARAMETERS_REVISION_4。

NDIS_BIND_PARAMETERS_REVISION_3

为 NDIS 6.20 添加了 ReceiveFilterCapabilities、 PowerManagementCapabilitiesEx 和 NicSwitchCapabilities 成员。

NDIS 将 Size 成员设置为 NDIS_SIZEOF_BIND_PARAMETERS_REVISION_3。

NDIS_BIND_PARAMETERS_REVISION_2

为 NDIS 6.1 添加了 HDSplitCurrentConfig 成员。

NDIS 将 Size 成员设置为 NDIS_SIZEOF_BIND_PARAMETERS_REVISION_2。

NDIS_BIND_PARAMETERS_REVISION_1

NDIS 6.0 的原始版本。

NDIS 将 Size 成员设置为 NDIS_SIZEOF_BIND_PARAMETERS_REVISION_1。

ProtocolSection

指向包含注册表路径的 Unicode 字符串的指针。路径从协议驱动程序的服务密钥开始，在注册表层次结构中一直持续到微型端口适配器名称 (例如 Tcpip\Parameters\Adapters\<miniport 适配器名称>) 。微型端口适配器名称是驱动程序堆栈中最底部的微型端口适配器的名称。如果堆栈中有 MUX 中间驱动程序，则最底部的微型端口适配器是虚拟微型端口。否则，最底部的微型端口适配器是物理设备的微型端口适配器。

协议驱动程序可以使用此注册表路径来读取特定于驱动程序与基础微型端口适配器之间的绑定的配置参数。

AdapterName

指向 Unicode 字符串的指针，该字符串包含 ProtocolBindAdapterEx 应绑定到的基础微型端口适配器的名称。

PhysicalDeviceObject

基础微型端口适配器的物理设备对象。

MediaType

基础微型端口适配器支持的 NdisMediumXxx 类型。有关 NdisMediumXxx 类型的详细信息，请参阅 NDIS_MEDIUM。

MtuSize

最大传输单位 (MTU) 大小。有关详细信息，请参阅 OID_GEN_MAXIMUM_FRAME_SIZE。

MaxXmitLinkSpeed

基础适配器的最大传输链路速度（以位/秒为单位）。有关详细信息，请参阅 OID_GEN_MAX_LINK_SPEED。

XmitLinkSpeed