NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES Struktur (ndis.h)
Ein NDIS-Miniporttreiber richtet eine NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES Struktur ein, um die allgemeinen Miniporttreiberattribute zu definieren, die einem Miniportadapter zugeordnet sind.
Syntax
typedef struct _NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES {
NDIS_OBJECT_HEADER Header;
ULONG Flags;
NDIS_MEDIUM MediaType;
NDIS_PHYSICAL_MEDIUM PhysicalMediumType;
ULONG MtuSize;
ULONG64 MaxXmitLinkSpeed;
ULONG64 XmitLinkSpeed;
ULONG64 MaxRcvLinkSpeed;
ULONG64 RcvLinkSpeed;
NDIS_MEDIA_CONNECT_STATE MediaConnectState;
NDIS_MEDIA_DUPLEX_STATE MediaDuplexState;
ULONG LookaheadSize;
PNDIS_PNP_CAPABILITIES PowerManagementCapabilities;
ULONG MacOptions;
ULONG SupportedPacketFilters;
ULONG MaxMulticastListSize;
USHORT MacAddressLength;
UCHAR PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
UCHAR CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
PNDIS_RECEIVE_SCALE_CAPABILITIES RecvScaleCapabilities;
NET_IF_ACCESS_TYPE AccessType;
NET_IF_DIRECTION_TYPE DirectionType;
NET_IF_CONNECTION_TYPE ConnectionType;
NET_IFTYPE IfType;
BOOLEAN IfConnectorPresent;
ULONG SupportedStatistics;
ULONG SupportedPauseFunctions;
ULONG DataBackFillSize;
ULONG ContextBackFillSize;
PNDIS_OID SupportedOidList;
ULONG SupportedOidListLength;
ULONG AutoNegotiationFlags;
PNDIS_PM_CAPABILITIES PowerManagementCapabilitiesEx;
} NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES, *PNDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES;
Angehörige
Header
Die NDIS_OBJECT_HEADER Struktur für die NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES Struktur. Legen Sie das element Type der Struktur fest, das Header- für NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_GENERAL_ATTRIBUTESangibt.
Um die Version der NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES-Struktur anzugeben, legen Sie den Revision Member auf einen der folgenden Werte fest:
NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_2
Das PowerManagementCapabilitiesEx Mitglied für NDIS 6.2 wurde hinzugefügt.
Legen Sie das element Size auf NDIS_SIZEOF_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_2fest.
NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_1
Originalversion für NDIS 6.0 und NDIS 6,1.
Legen Sie das Size Member auf NDIS_SIZEOF_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_1fest.
Flags
Reserviert für NDIS.
MediaType
Der NdisMediumXxx Typ, den der Miniportadapter unterstützt. Weitere Informationen finden Sie unter NDIS_MEDIUM.
PhysicalMediumType
Der physische Mitteltyp für den Miniportadapter. Weitere Informationen finden Sie unter OID_GEN_PHYSICAL_MEDIUM
MtuSize
Die maximale Übertragungseinheitsgröße (MTU). Weitere Informationen finden Sie unter OID_GEN_MAXIMUM_FRAME_SIZE.
MaxXmitLinkSpeed
Die maximale Übertragungsgeschwindigkeit des Adapters in Bits pro Sekunde. Weitere Informationen finden Sie unter OID_GEN_MAX_LINK_SPEED.
XmitLinkSpeed
Die aktuelle Übertragungsverbindungsgeschwindigkeit des Adapters in Bits pro Sekunde. Weitere Informationen finden Sie unter OID_GEN_LINK_SPEED_EX.
MaxRcvLinkSpeed
Die maximale Empfangsverbindungsgeschwindigkeit des Adapters in Bits pro Sekunde. Weitere Informationen finden Sie unter OID_GEN_MAX_LINK_SPEED.
RcvLinkSpeed
Die aktuelle Verbindungsgeschwindigkeit des Adapters in Bits pro Sekunde. Weitere Informationen finden Sie unter OID_GEN_LINK_SPEED_EX.
MediaConnectState
Der Medienverbindungszustand für den Miniportadapter. Weitere Informationen finden Sie unter OID_GEN_MEDIA_CONNECT_STATUS_EX.
MediaDuplexState
Der Medienduplexzustand für den Miniportadapter. Weitere Informationen finden Sie unter OID_GEN_MEDIA_DUPLEX_STATE.
LookaheadSize
Die Lookaheadgröße für den Miniportadapter. Weitere Informationen finden Sie unter OID_GEN_CURRENT_LOOKAHEAD.
PowerManagementCapabilities
Die Plug and Play-Funktionen (PnP) des Miniportadapters. Weitere Informationen zu PnP-Funktionen finden Sie unter OID_PNP_CAPABILITIES. Wenn der Miniportadapter keine Energieverwaltung unterstützt, sollte der Miniporttreiber PowerManagementCapabilities- auf NULL-festlegen. Stattdessen müssen NDIS 6.20 und höhere Treiber das PowerManagementCapabilitiesEx Member verwenden.
MacOptions
Die MAC-Optionen für den Miniportadapter. Weitere Informationen finden Sie unter OID_GEN_MAC_OPTIONS.
SupportedPacketFilters
Die Paketfilterkennzeichnungen für den Miniportadapter.
MaxMulticastListSize
Die Multicast-Adresslistengröße für den Miniportadapter. Weitere Informationen finden Sie unter OID_802_3_MAXIMUM_LIST_SIZE.
MacAddressLength
Die LÄNGE der MAC-Adresse in Byte. Die MAC-Adresslänge ist spezifisch für den Medientyp.
PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]
Die permanente MAC-Adresse. Beispielsweise gibt das OID_802_3_PERMANENT_ADDRESS OID die permanente MAC-Adresse für IEEE 802.3-Treiber an.
CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]
Die aktuelle MAC-Adresse. Beispielsweise gibt das OID_802_3_CURRENT_ADDRESS OID die aktuelle MAC-Adresse für IEEE 802.3-Treiber an.
RecvScaleCapabilities
Die Rss-Funktionen (Receive Side Scaling) der NIC. Wenn der Miniportadapter das RSS-Feature nicht unterstützt, legen Sie RecvScaleCapabilities- auf NULL-fest. Weitere Informationen zu RSS finden Sie unter OID_GEN_RECEIVE_SCALE_CAPABILITIES.
AccessType
Ein NET_IF_ACCESS_TYPE NDIS-Netzwerkschnittstellenzugriffstyp.
DirectionType
Ein NET_IF_DIRECTION_TYPE NDIS-Netzwerkschnittstellenrichtungstyp.
ConnectionType
Ein NET_IF_CONNECTION_TYPE NDIS-Netzwerkschnittstellenverbindungstyp.
IfType
Der Schnittstellentyp Internet Assigned Numbers Authority (IANA). Beispielsweise ist IF_TYPE_ETHERNET_CSMACD (6) der Wert für IfType-, der einer beliebigen Ethernet-ähnlichen Schnittstelle zugewiesen ist. Eine Liste, wenn Schnittstellentypen vorhanden sind, finden Sie unter NDIS-Schnittstellentypen.
IfConnectorPresent
Ein boolescher Wert, der angibt, ob ein Connector vorhanden ist. Legen Sie diesen Wert auf TRUE- fest, wenn ein physischer Adapter vorhanden ist.
SupportedStatistics
Die unterstützten Statistiken.
NDIS_STATISTICS_DIRECTED_FRAMES_RCV_SUPPORTED
Die Daten im ifHCInUcastPkts Member sind gültig.
NDIS_STATISTICS_MULTICAST_FRAMES_RCV_SUPPORTED
Die Daten im ifHCInMulticastPkts Mitglied der NDIS_STATISTICS_INFO gültig.
NDIS_STATISTICS_BROADCAST_FRAMES_RCV_SUPPORTED
Die Daten im ifHCInBroadcastPkts Mitglied von NDIS_STATISTICS_INFO gültig.
NDIS_STATISTICS_BYTES_RCV_SUPPORTED
Die Daten im ifHCInOctets Mitglied der NDIS_STATISTICS_INFO gültig.
NDIS_STATISTICS_RCV_DISCARDS_SUPPORTED
Die Daten im ifInDiscards Mitglied von NDIS_STATISTICS_INFO gültig.
NDIS_STATISTICS_RCV_ERROR_SUPPORTED
Die Daten im ifInErrors Member von NDIS_STATISTICS_INFO gültig.
NDIS_STATISTICS_DIRECTED_FRAMES_XMIT_SUPPORTED
Die Daten im ifHCOutUcastPkts Mitglied der NDIS_STATISTICS_INFO gültig.
NDIS_STATISTICS_MULTICAST_FRAMES_XMIT_SUPPORTED
Die Daten im ifHCOutMulticastPkts Member von NDIS_STATISTICS_INFO gültig.
NDIS_STATISTICS_BROADCAST_FRAMES_XMIT_SUPPORTED
Die Daten im ifHCOutBroadcastPkts Mitglied der NDIS_STATISTICS_INFO gültig.
NDIS_STATISTICS_BYTES_XMIT_SUPPORTED
Die Daten im ifHCOutOctets Mitglied der NDIS_STATISTICS_INFO gültig.
NDIS_STATISTICS_XMIT_ERROR_SUPPORTED
Die Daten im ifOutErrors Mitglied von NDIS_STATISTICS_INFO sind gültig.
NDIS_STATISTICS_XMIT_DISCARDS_SUPPORTED
Die Daten im ifOutDiscards Mitglied von NDIS_STATISTICS_INFO gültig.
NDIS_STATISTICS_DIRECTED_BYTES_RCV_SUPPORTED
Die Daten im ifHCInUcastOctets Mitglied von NDIS_STATISTICS_INFO gültig.
NDIS_STATISTICS_MULTICAST_BYTES_RCV_SUPPORTED
Die Daten im ifHCInMulticastOctets Mitglied von NDIS_STATISTICS_INFO gültig.
NDIS_STATISTICS_BROADCAST_BYTES_RCV_SUPPORTED
Die Daten im ifHCInBroadcastOctets Mitglied der NDIS_STATISTICS_INFO gültig.
NDIS_STATISTICS_DIRECTED_BYTES_XMIT_SUPPORTED
Die Daten im ifHCOutUcastOctets Mitglied von NDIS_STATISTICS_INFO gültig.
NDIS_STATISTICS_MULTICAST_BYTES_XMIT_SUPPORTED
Die Daten im ifHCOutMulticastOctets Mitglied von NDIS_STATISTICS_INFO gültig.
NDIS_STATISTICS_BROADCAST_BYTES_XMIT_SUPPORTED
Die Daten im ifHCOutBroadcastOctets Mitglied von NDIS_STATISTICS_INFO gültig.
SupportedPauseFunctions
Unterstützung für ieee 802.3 pause frames as one of the following pause functions:
NdisPauseFunctionsUnsupported
Gibt an, dass der Adapter- oder Linkpartner keine Pausenframes unterstützt.
NdisPauseFunctionsSendOnly
Gibt an, dass der Adapter und der Linkpartner nur das Senden von Pauseframes vom Adapter an den Linkpartner unterstützen.
NdisPauseFunctionsReceiveOnly
Gibt an, dass der Adapter und der Linkpartner nur das Senden von Pauseframes vom Linkpartner an den Adapter unterstützen.
NdisPauseFunctionsSendAndReceive
Gibt an, dass der Adapter und der Linkpartner das Senden und Empfangen von Pausenframes sowohl in Transint als auch in Empfangsbeschreibungen unterstützen.
NdisPauseFunctionsUnknown
Gibt an, dass die Aushandlung des Pauseframes ausgeführt wird. Die Unterstützung des Pauseframes, die der Linkpartner bereitstellt, ist unbekannt.
DataBackFillSize
Die erforderliche Größe des Datenrückfüllbereichs (in Byte) des Treibers.
ContextBackFillSize
Die erforderliche Größe des Kontextrückfüllbereichs (in Byte) des Treibers.
SupportedOidList
Eine Liste der OIDs, die der Miniporttreiber unterstützt. Weitere Informationen finden Sie unter OID_GEN_SUPPORTED_LIST.
SupportedOidListLength
Die Größe der OID-Liste in Bytes bei SupportedOidList .
AutoNegotiationFlags
Die Einstellungen für die automatische Aushandlung für den Miniportadapter. Dieses Element wird aus einem bitweisen OR der folgenden Flags erstellt:
NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED
Der Adapter hat die Übertragungsverbindungsgeschwindigkeit automatisch mit dem Linkpartner ausgehandelt.
NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED
Der Adapter hat die Empfangsverbindungsgeschwindigkeit automatisch mit dem Linkpartner ausgehandelt.
NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED
Der Adapter hat den Duplexzustand automatisch mit dem Linkpartner ausgehandelt.
NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED
Der Adapter hat die Pausenfunktionen automatisch mit dem Linkpartner ausgehandelt.
PowerManagementCapabilitiesEx
Ein Zeiger auf eine NDIS_PM_CAPABILITIES Struktur. Diese Struktur gibt die Leistungsverwaltungsfunktionen des Miniportadapters an. Dieses Mitglied ist für NDIS 6.20 und höhere Treiber obligatorisch.
Bemerkungen
Ein Miniporttreiber übergibt einen Zeiger an eine NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES Struktur im MiniportAttributes Parameter des NdisMSetMiniportAttributes Funktion. Ein Miniporttreiber ruft NdisMSetMiniportAttributes aus seiner MiniportInitializeEx--Funktion während der Initialisierung auf. Miniport-Treiber sollten diese Attribute festlegen, nachdem sie die Registrierungsattribute in der NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES Struktur und vor dem Festlegen anderer Attribute. Das Festlegen dieses Attributs ist obligatorisch.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Header- | ndis.h (include Ndis.h) |