Windows Driver Kit: Network Devices and Protocols
NDIS_RESTART_GENERAL_ATTRIBUTES
The NDIS_RESTART_GENERAL_ATTRIBUTES structure defines the general restart attributes that are associated with a miniport adapter.
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;
Members
- Header
- The NDIS_OBJECT_HEADER structure for the NDIS_RESTART_GENERAL_ATTRIBUTES structure. NDIS sets the Type member of the structure that Header specifies to NDIS_OBJECT_TYPE_RESTART_GENERIC_ATTRIBUTES.
To indicate the version of the NDIS_RESTART_GENERAL_ATTRIBUTES structure, NDIS sets the Revision member to one of the following values:
- NDIS_RESTART_GENERAL_ATTRIBUTES_REVISION_2
- Added the MaxLookaheadSizeAccessed member.
NDIS sets the Size member to NDIS_SIZEOF_RESTART_GENERAL_ATTRIBUTES_REVISION_2.
- NDIS_RESTART_GENERAL_ATTRIBUTES_REVISION_1
- Original version.
NDIS sets the Size member to NDIS_SIZEOF_RESTART_GENERAL_ATTRIBUTES_REVISION_1.
- MtuSize
- The maximum transfer unit (MTU) size. For more information, see OID_GEN_MAXIMUM_FRAME_SIZE.
- MaxXmitLinkSpeed
- The maximum transmit link speed of the adapter in bits per second. For more information, see OID_GEN_MAX_LINK_SPEED.
- MaxRcvLinkSpeed
- The maximum receive link speed of the adapter in bits per second. For more information, see OID_GEN_MAX_LINK_SPEED.
- LookaheadSize
- The lookahead size for the miniport adapter. For more information, see OID_GEN_CURRENT_LOOKAHEAD.
- MacOptions
- The medium access control (MAC) options for the miniport adapter. For more information, see OID_GEN_MAC_OPTIONS.
- SupportedPacketFilters
- The packet filter flags for the miniport adapter. For more information, see OID_GEN_SUPPORTED_PACKET_FILTERS.
- MaxMulticastListSize
- The multicast list size for the miniport adapter. For more information, see OID_802_3_MAXIMUM_LIST_SIZE.
- RecvScaleCapabilities
- The receive-side scaling (RSS) capabilities of the NIC. If the miniport adapter does not support the RSS feature, NDIS sets RecvScaleCapabilities to a pointer to an NDIS_RECEIVE_SCALE_CAPABILITIES structure that is filled with zeros. For more information about RSS, see OID_GEN_RECEIVE_SCALE_CAPABILITIES.
- AccessType
- A NET_IF_ACCESS_TYPE NDIS network interface access type.
- Flags
- Reserved.
- ConnectionType
- A NET_IF_CONNECTION_TYPE NDIS network interface connection type.
- SupportedStatistics
- The supported statistics. For more information, see the SupportedStatistics member of the NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES structure.
- DataBackFillSize
- The required data backfill size, in bytes, of the driver.
- ContextBackFillSize
- The required context backfill size, in bytes, of the driver.
- SupportedOidList
- A list of OIDs that the miniport driver supports. For more information, see OID_GEN_SUPPORTED_LIST.
- SupportedOidListLength
- The size, in bytes, of the OID list that is specified in the SupportedOidList member.
- MaxLookaheadSizeAccessed
- A ULONG value for the maximum size, in bytes, of the lookahead size requirement for receive queues. A miniport adapter that supports lookahead in VM queues splits a received packet at an offset equal to or greater than the requested lookahead size and DMAs the lookahead data and the post-lookahead data to separate shared memory segments.
Comments
NDIS passes an NDIS_RESTART_GENERAL_ATTRIBUTES structure to drivers during restart operations. For example, when NDIS calls a miniport driver's MiniportRestart function, NDIS passes a pointer to an NDIS_RESTART_ATTRIBUTES structure to the miniport driver in the RestartAttributes member of the NDIS_MINIPORT_RESTART_PARAMETERS structure.
If the Oid member in the NDIS_RESTART_ATTRIBUTES structure is OID_GEN_MINIPORT_RESTART_ATTRIBUTES, the Data member of NDIS_RESTART_ATTRIBUTES contains an NDIS_RESTART_GENERAL_ATTRIBUTES structure.
Requirements
Versions: Supported for NDIS 6.20 drivers starting in Windows 7. NDIS 6.20 drivers use NDIS_RESTART_GENERAL_ATTRIBUTES_REVISION_2. Supported for NDIS 6.0 drivers starting in Windows Vista. NDIS 6.0 and NDIS 6.1 drivers use N NDIS_RESTART_GENERAL_ATTRIBUTES_REVISION_1.
Headers: Declared in Ndis.h. Include Ndis.h.
See Also
MiniportRestart, NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES, NDIS_MINIPORT_RESTART_PARAMETERS, NDIS_OBJECT_HEADER, NDIS_RECEIVE_SCALE_CAPABILITIES, NDIS_RESTART_ATTRIBUTES, NET_IF_ACCESS_TYPE, NET_IF_CONNECTION_TYPE, NET_IF_DIRECTION_TYPE, OID_802_3_MAXIMUM_LIST_SIZE, OID_GEN_CURRENT_LOOKAHEAD, OID_GEN_MAC_OPTIONS, OID_GEN_MAX_LINK_SPEED, OID_GEN_MAXIMUM_FRAME_SIZE, OID_GEN_MINIPORT_RESTART_ATTRIBUTES, OID_GEN_STATISTICS, OID_GEN_SUPPORTED_LIST, OID_GEN_SUPPORTED_PACKET_FILTERS, OID_PNP_CAPABILITIES