(ndis.h) NDIS_RESTART_GENERAL_ATTRIBUTES 结构

项目
04/13/2023

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

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

NDIS_RESTART_GENERAL_ATTRIBUTES_REVISION_2

为 NDIS 6.2 添加了 MaxLookaheadSizeAccessed 成员。

NDIS 将 Size 成员设置为 NDIS_SIZEOF_RESTART_GENERAL_ATTRIBUTES_REVISION_2。

NDIS_RESTART_GENERAL_ATTRIBUTES_REVISION_1

NDIS 6.0 和 NDIS 6.1 的原始版本。

NDIS 将 Size 成员设置为 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

接收方缩放 (RSS) NIC 的功能。如果微型端口适配器不支持 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 的微型端口适配器以等于或大于所请求的 lookahead 大小和 DMA 的偏移量拆分接收的数据包，并将 lookahead 数据和后查找数据拆分为分隔共享内存段。

注解

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的 Data 成员包含NDIS_RESTART_GENERAL_ATTRIBUTES结构。