NDIS_BIND_PARAMETERS結構（ndis.h）

發行項
02/07/2025

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 指定為NDIS_OBJECT_TYPE_BIND_PARAMETERS之結構的 Type 成員。

若要指出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

已新增 ReceiveFilterCapabilities、PowerManagementCapabilitiesEx，以及 NicSwitchCapabilities NDIS 6.20 的成員。

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\<迷你埠適配卡名稱>）。迷你埠配接器名稱是驅動程式堆疊中最下層迷你埠配接器的名稱。如果堆疊中有 MUX 中繼驅動程式，則最下層迷你埠配接器是虛擬迷你埠。否則，最底層的迷你埠適配卡是實體裝置的迷你埠適配卡。

通訊協定驅動程式可以使用此登錄路徑來讀取驅動程式與基礎迷你埠適配卡之間系結特有的組態參數。

AdapterName

Unicode 字串的指標，其中包含基礎迷你埠配接器的名稱，ProtocolBindAdapterEx 應該系結。

PhysicalDeviceObject

基礎迷你埠配接器的實體裝置物件。

MediaType

基礎迷你埠配接器支援的 NdisMediumXxx 類型。如需 NdisMediumXxx 類型的詳細資訊，請參閱 NDIS_MEDIUM。

MtuSize

最大傳輸單位（MTU）大小。如需詳細資訊，請參閱 OID_GEN_MAXIMUM_FRAME_SIZE。

MaxXmitLinkSpeed

每秒以位為單位的基礎配接器傳輸連結速度上限。如需詳細資訊，請參閱 OID_GEN_MAX_LINK_SPEED。

XmitLinkSpeed