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 會將 Header 指定為 NDIS_OBJECT_TYPE_RESTART_GENERIC_ATTRIBUTES之結構 Type 成員。

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

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 的迷你埠配接器，會分割接收的封包，位移等於或大於所要求的外觀大小和查閱頭數據，以及查閱後數據以分隔共用記憶體區段。

言論

NDIS 會在重新啟動作業期間將NDIS_RESTART_GENERAL_ATTRIBUTES結構傳遞給驅動程式。例如，當 NDIS 呼叫迷你埠驅動程式的 MiniportRestart 函式時，NDIS 會將指標傳遞至 RestartAttributes 成員中的 miniport 驅動程式 NDIS_RESTART_ATTRIBUTES 結構 NDIS_MINIPORT_RESTART_PARAMETERS 結構。

如果 NDIS_RESTART_ATTRIBUTES 結構中的 Oid 成員為 OID_GEN_MINIPORT_RESTART_ATTRIBUTES，NDIS_RESTART_ATTRIBUTES的 Data 成員包含NDIS_RESTART_GENERAL_ATTRIBUTES結構。