NDIS_RESTART_GENERAL_ATTRIBUTES-Struktur (ndis.h)

Artikel
02/29/2024

Die NDIS_RESTART_GENERAL_ATTRIBUTES-Struktur definiert die allgemeinen Neustartattribute, die einem Miniportadapter zugeordnet sind.

Syntax

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;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die NDIS_RESTART_GENERAL_ATTRIBUTES-Struktur . NDIS legt das Type-Element der Struktur fest, die Header angibt, auf NDIS_OBJECT_TYPE_RESTART_GENERIC_ATTRIBUTES.

Um die Version der NDIS_RESTART_GENERAL_ATTRIBUTES-Struktur anzugeben, legt NDIS den Revisionsmember auf einen der folgenden Werte fest:

NDIS_RESTART_GENERAL_ATTRIBUTES_REVISION_2

Das MaxLookaheadSizeAccessed-Element für NDIS 6.2 wurde hinzugefügt.

NDIS legt das Element Größe auf NDIS_SIZEOF_RESTART_GENERAL_ATTRIBUTES_REVISION_2 fest.

NDIS_RESTART_GENERAL_ATTRIBUTES_REVISION_1

Ursprüngliche Version für NDIS 6.0 und NDIS 6.1.

NDIS legt das Element Größe auf NDIS_SIZEOF_RESTART_GENERAL_ATTRIBUTES_REVISION_1 fest.

MtuSize

Die maximale MTU-Größe (Transfer Unit). Weitere Informationen finden Sie unter OID_GEN_MAXIMUM_FRAME_SIZE.

MaxXmitLinkSpeed

Die maximale Übertragungslinkgeschwindigkeit des Adapters in Bits pro Sekunde. Weitere Informationen finden Sie unter OID_GEN_MAX_LINK_SPEED.

MaxRcvLinkSpeed

Die maximale Empfangslinkgeschwindigkeit des Adapters in Bits pro Sekunde. Weitere Informationen finden Sie unter OID_GEN_MAX_LINK_SPEED.

LookaheadSize

Die Lookahead-Größe für den Miniportadapter. Weitere Informationen finden Sie unter OID_GEN_CURRENT_LOOKAHEAD.

MacOptions

Die MAC-Optionen (Medium Access Control) für den Miniportadapter. Weitere Informationen finden Sie unter OID_GEN_MAC_OPTIONS.

SupportedPacketFilters

Die Paketfilterflags für den Miniportadapter.

MaxMulticastListSize

Die maximale Größe der Multicastadressenliste für den Miniportadapter. Weitere Informationen finden Sie unter OID_802_3_MAXIMUM_LIST_SIZE.

RecvScaleCapabilities

Die RSS-Funktionen (Receive Side Scaling) der NIC. Wenn der Miniportadapter das RSS-Feature nicht unterstützt, legt NDIS RecvScaleCapabilities auf einen Zeiger auf ein fest. NDIS_RECEIVE_SCALE_CAPABILITIES Struktur, die mit Nullen gefüllt ist. Weitere Informationen zu RSS finden Sie unter OID_GEN_RECEIVE_SCALE_CAPABILITIES.

AccessType

Ein NET_IF_ACCESS_TYPE NDIS-Netzwerkschnittstellenzugriffstyp.

Flags

Reserviert.

ConnectionType

Ein NET_IF_CONNECTION_TYPE NDIS-Netzwerkschnittstellenverbindungstyp.

SupportedStatistics

Die unterstützten Statistiken. Weitere Informationen finden Sie im SupportedStatistics-Member des NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES Struktur.

DataBackFillSize

Die erforderliche Datenbackfillgröße des Treibers in Bytes.

ContextBackFillSize

Die erforderliche Kontextbackfillgröße des Treibers in Bytes.

SupportedOidList

Eine Liste der vom Miniporttreiber unterstützten OIDs. Weitere Informationen finden Sie unter OID_GEN_SUPPORTED_LIST.

SupportedOidListLength

Die Größe der OID-Liste in Bytes, die im SupportedOidList-Element angegeben ist.

MaxLookaheadSizeAccessed

Ein ULONG-Wert für die maximale Größe der Lookahead-Größenanforderung für Empfangswarteschlangen in Bytes. Ein Miniportadapter, der Lookahead in VM-Warteschlangen unterstützt, teilt ein empfangenes Paket mit einem Offset auf, der der angeforderten Lookaheadgröße entspricht oder größer ist, und dmAs die Lookahead-Daten und die Nach-Lookahead-Daten, um freigegebene Speichersegmente zu trennen.

Hinweise

NDIS übergibt bei Neustartvorgängen eine NDIS_RESTART_GENERAL_ATTRIBUTES-Struktur an Treiber. Wenn NDIS beispielsweise die MiniportRestart-Funktion eines Miniporttreibers aufruft, übergibt NDIS einen Zeiger auf eine NDIS_RESTART_ATTRIBUTES Struktur an den Miniporttreiber im RestartAttributes-Member des NDIS_MINIPORT_RESTART_PARAMETERS Struktur.

Wenn das OID-Element in der NDIS_RESTART_ATTRIBUTES-Struktur ist OID_GEN_MINIPORT_RESTART_ATTRIBUTES enthält das Datenelement von NDIS_RESTART_ATTRIBUTES eine NDIS_RESTART_GENERAL_ATTRIBUTES-Struktur.