NDIS_RESTART_GENERAL_ATTRIBUTES结构（ndis.h）

项目
02/07/2025

NDIS_RESTART_GENERAL_ATTRIBUTES 结构定义与微型端口适配器关联的常规重启属性。

语法

typedef struct _NDIS_RESTART_GENERAL_ATTRIBUTES {
  NDIS_OBJECT_HEADER               Header;
  ULONG                            MtuSize;
  ULONG64                          MaxXmitLinkSpeed;
  ULONG64                          MaxRcvLinkSpeed;
  ULONG                            LookaheadSize;
  ULONG                            MacOptions;
  ULONG                            SupportedPacketFilters;
  ULONG                            MaxMulticastListSize;
  PNDIS_RECEIVE_SCALE_CAPABILITIES RecvScaleCapabilities;
  NET_IF_ACCESS_TYPE               AccessType;
  ULONG                            Flags;
  NET_IF_CONNECTION_TYPE           ConnectionType;
  ULONG                            SupportedStatistics;
  ULONG                            DataBackFillSize;
  ULONG                            ContextBackFillSize;
  PNDIS_OID                        SupportedOidList;
  ULONG                            SupportedOidListLength;
  ULONG                            MaxLookaheadSizeAccessed;
} NDIS_RESTART_GENERAL_ATTRIBUTES, *PNDIS_RESTART_GENERAL_ATTRIBUTES;

成员

Header

NDIS_RESTART_GENERAL_ATTRIBUTES 结构的 NDIS_OBJECT_HEADER 结构。 NDIS 将标头指定为 NDIS_OBJECT_TYPE_RESTART_GENERIC_ATTRIBUTES的结构类型成员。

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

NDIS_RESTART_GENERAL_ATTRIBUTES_REVISION_2

为 NDIS 6.2 添加了 MaxLookaheadSizeAccessed 成员。

NDIS 将大小成员设置为 NDIS_SIZEOF_RESTART_GENERAL_ATTRIBUTES_REVISION_2。

NDIS_RESTART_GENERAL_ATTRIBUTES_REVISION_1

NDIS 6.0 和 NDIS 6.1 的原始版本。

NDIS 将大小成员设置为 NDIS_SIZEOF_RESTART_GENERAL_ATTRIBUTES_REVISION_1。

MtuSize

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

MaxXmitLinkSpeed

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

MaxRcvLinkSpeed

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

LookaheadSize

微型端口适配器的外观大小。有关详细信息，请参阅 OID_GEN_CURRENT_LOOKAHEAD。

MacOptions

微型端口适配器的中等访问控制（MAC）选项。有关详细信息，请参阅 OID_GEN_MAC_OPTIONS。

SupportedPacketFilters

微型端口适配器的数据包筛选器标志。

MaxMulticastListSize

微型端口适配器的最大多播地址列表大小。有关详细信息，请参阅 OID_802_3_MAXIMUM_LIST_SIZE。

RecvScaleCapabilities

NIC 的接收端缩放（RSS）功能。如果微型端口适配器不支持 RSS 功能，NDIS 会将 RecvScaleCapabilities 设置为指向某个指针的指针 NDIS_RECEIVE_SCALE_CAPABILITIES 用零填充的结构。有关 RSS 的详细信息，请参阅 OID_GEN_RECEIVE_SCALE_CAPABILITIES。

AccessType

NET_IF_ACCESS_TYPE NDIS 网络接口访问类型。

Flags

保留。

ConnectionType

NET_IF_CONNECTION_TYPE NDIS 网络接口连接类型。

SupportedStatistics

支持的统计信息。有关详细信息，请参阅 SupportedStatistics 成员 NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES 结构。

DataBackFillSize

驱动程序所需的数据回填大小（以字节为单位）。

ContextBackFillSize

驱动程序所需的上下文回填大小（以字节为单位）。

SupportedOidList

微型端口驱动程序支持的 OID 列表。有关详细信息，请参阅 OID_GEN_SUPPORTED_LIST。

SupportedOidListLength

SupportedOidList 成员中指定的 OID 列表的大小（以字节为单位）。

MaxLookaheadSizeAccessed

接收队列的最大大小（以字节为单位）的 ULONG 值。支持 VM 队列中的 lookahead 的微型端口适配器将接收的数据包拆分为偏移量等于或大于所请求的看头大小和查找头数据以及查找后数据以分隔共享内存段的 DMA。

言论

NDIS 在重启作期间将NDIS_RESTART_GENERAL_ATTRIBUTES结构传递给驱动程序。例如，当 NDIS 调用微型端口驱动程序的 MiniportRestart 函数时，NDIS 会将指向 NDIS_RESTART_ATTRIBUTES 结构的指针传递给 RestartAttributes 成员中的微型端口驱动程序 NDIS_MINIPORT_RESTART_PARAMETERS 结构。

如果NDIS_RESTART_ATTRIBUTES结构中的 Oid 成员为 OID_GEN_MINIPORT_RESTART_ATTRIBUTES，NDIS_RESTART_ATTRIBUTES的数据成员包含NDIS_RESTART_GENERAL_ATTRIBUTES结构。