NDIS_BIND_PARAMETERS 結構 (ndis.h)

發行項
02/29/2024

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