structure NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES (ndis.h)
Un pilote miniport NDIS configure une structure NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES pour définir les attributs généraux du pilote miniport associé à un adaptateur miniport.
Syntaxe
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;
Membres
Header
Structure NDIS_OBJECT_HEADER pour la structure NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES. Définissez le membre Type de la structure qui Header spécifie la valeur NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES.
Pour indiquer la version de la structure NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES, définissez le membre révision sur l’une des valeurs suivantes :
NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_2
Ajout du membre PowerManagementCapabilitiesEx pour NDIS 6.2.
Définissez le membre Size sur NDIS_SIZEOF_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_2.
NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_1
Version d’origine pour NDIS 6.0 et NDIS 6,1.
Définissez le membre Size sur NDIS_SIZEOF_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_1.
Flags
Réservé à NDIS.
MediaType
Le type NdisMediumXxx pris en charge par l’adaptateur miniport. Pour plus d’informations, consultez NDIS_MEDIUM.
PhysicalMediumType
Type de support physique pour l’adaptateur miniport. Pour plus d’informations, consultez OID_GEN_PHYSICAL_MEDIUM
MtuSize
Taille maximale de l’unité de transfert (MTU). Pour plus d’informations, consultez OID_GEN_MAXIMUM_FRAME_SIZE.
MaxXmitLinkSpeed
Vitesse maximale de transmission de l’adaptateur en bits par seconde. Pour plus d’informations, consultez OID_GEN_MAX_LINK_SPEED.
XmitLinkSpeed
Vitesse de transmission actuelle de l’adaptateur en bits par seconde. Pour plus d’informations, consultez OID_GEN_LINK_SPEED_EX.
MaxRcvLinkSpeed
Vitesse maximale de liaison de réception de l’adaptateur en bits par seconde. Pour plus d’informations, consultez OID_GEN_MAX_LINK_SPEED.
RcvLinkSpeed
Vitesse de liaison de réception actuelle de l’adaptateur en bits par seconde. Pour plus d’informations, consultez OID_GEN_LINK_SPEED_EX.
MediaConnectState
État de connexion multimédia pour l’adaptateur miniport. Pour plus d’informations, consultez OID_GEN_MEDIA_CONNECT_STATUS_EX.
MediaDuplexState
État duplex multimédia de l’adaptateur miniport. Pour plus d’informations, consultez OID_GEN_MEDIA_DUPLEX_STATE.
LookaheadSize
Taille de lookahead pour l’adaptateur miniport. Pour plus d’informations, consultez OID_GEN_CURRENT_LOOKAHEAD.
PowerManagementCapabilities
Fonctionnalités Plug-and-Play (PnP) de l’adaptateur miniport. Pour plus d’informations sur les fonctionnalités PnP, consultez OID_PNP_CAPABILITIES. Si l’adaptateur miniport n’est pas prenant en charge la gestion de l’alimentation, le pilote miniport doit définir PowerManagementCapabilities sur NULL. Les pilotes NDIS 6.20 et ultérieurs doivent utiliser le membre PowerManagementCapabilitiesEx à la place.
MacOptions
Options MAC pour l’adaptateur miniport. Pour plus d’informations, consultez OID_GEN_MAC_OPTIONS.
SupportedPacketFilters
Indicateurs de filtre de paquets pour l’adaptateur miniport.
MaxMulticastListSize
Taille de la liste d’adresses de multidiffusion pour l’adaptateur miniport. Pour plus d’informations, consultez OID_802_3_MAXIMUM_LIST_SIZE.
MacAddressLength
Longueur de l’adresse MAC, en octets. La longueur de l’adresse MAC est spécifique au type de média.
PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]
Adresse MAC permanente. Par exemple, l’OID OID_802_3_PERMANENT_ADDRESS spécifie l’adresse MAC permanente pour les pilotes IEEE 802.3.
CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]
Adresse MAC actuelle. Par exemple, l’OID OID_802_3_CURRENT_ADDRESS spécifie l’adresse MAC actuelle pour les pilotes IEEE 802.3.
RecvScaleCapabilities
Fonctionnalités de mise à l’échelle côté réception (RSS) de la carte réseau. Si l’adaptateur miniport ne prend pas en charge la fonctionnalité RSS, définissez RecvScaleCapabilities sur NULL. Pour plus d’informations sur RSS, consultez OID_GEN_RECEIVE_SCALE_CAPABILITIES.
AccessType
Type d’accès de l’interface réseau NDIS NET_IF_ACCESS_TYPE.
DirectionType
Type de direction de l’interface réseau NDIS NET_IF_DIRECTION_TYPE.
ConnectionType
Type de connexion d’interface réseau NDIS NET_IF_CONNECTION_TYPE.
IfType
Type d’interface IANA (Internet Assigned Numbers Authority). Par exemple, IF_TYPE_ETHERNET_CSMACD (6) est la valeur de IfType affecté à n’importe quelle interface de type Ethernet. Pour obtenir une liste si les types d’interface, consultez types d’interface NDIS.
IfConnectorPresent
Valeur booléenne qui indique si un connecteur est présent. Définissez cette valeur sur TRUE s’il existe un adaptateur physique.
SupportedStatistics
Statistiques prises en charge.
NDIS_STATISTICS_DIRECTED_FRAMES_RCV_SUPPORTED
Les données de l'siHCInUcastPkts membre sont valides.
NDIS_STATISTICS_MULTICAST_FRAMES_RCV_SUPPORTED
Les données de l'siHCInMulticastPkts membre de NDIS_STATISTICS_INFO est valide.
NDIS_STATISTICS_BROADCAST_FRAMES_RCV_SUPPORTED
Les données de l'ifHCInBroadcastPkts membre de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_BYTES_RCV_SUPPORTED
Les données de l'ifHCInOctets membre de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_RCV_DISCARDS_SUPPORTED
Les données de l'siInDiscards membre de NDIS_STATISTICS_INFO est valide.
NDIS_STATISTICS_RCV_ERROR_SUPPORTED
Les données de l'ifInErrors membre de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_DIRECTED_FRAMES_XMIT_SUPPORTED
Les données de l'siHCOutUcastPkts membre de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_MULTICAST_FRAMES_XMIT_SUPPORTED
Les données de l'ifHCOutMulticastPkts membre de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_BROADCAST_FRAMES_XMIT_SUPPORTED
Les données de l'ifHCOutBroadcastPkts membre de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_BYTES_XMIT_SUPPORTED
Les données de l'ifHCOutOctets membre de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_XMIT_ERROR_SUPPORTED
Les données de l'ifOutErrors membre de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_XMIT_DISCARDS_SUPPORTED
Les données de l'ifOutDiscards membre de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_DIRECTED_BYTES_RCV_SUPPORTED
Les données de l'ifHCInUcastOctets membre de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_MULTICAST_BYTES_RCV_SUPPORTED
Les données de l'ifHCInMulticastOctets membre de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_BROADCAST_BYTES_RCV_SUPPORTED
Les données de l'ifHCInBroadcastOctets membre de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_DIRECTED_BYTES_XMIT_SUPPORTED
Les données de l'siHCOutUcastOctets membre de NDIS_STATISTICS_INFO est valide.
NDIS_STATISTICS_MULTICAST_BYTES_XMIT_SUPPORTED
Les données de l'ifHCOutMulticastOctets membre de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_BROADCAST_BYTES_XMIT_SUPPORTED
Les données de l'ifHCOutBroadcastOctets membre de NDIS_STATISTICS_INFO sont valides.
SupportedPauseFunctions
Prise en charge des images de pause IEEE 802.3 comme l’une des fonctions de pause suivantes :
NdisPauseFunctionsUnsupported
Indique que l’adaptateur ou le partenaire de liaison ne prend pas en charge les trames de pause.
NdisPauseFunctionsSendOnly
Indique que l’adaptateur et le partenaire de liaison prennent uniquement en charge l’envoi de trames de pause de l’adaptateur au partenaire de liaison.
NdisPauseFunctionsReceiveOnly
Indique que l’adaptateur et le partenaire de liaison prennent uniquement en charge l’envoi de trames de pause du partenaire de lien à l’adaptateur
NdisPauseFunctionsSendAndReceive
Indique que l’adaptateur et le partenaire de liaison prennent en charge l’envoi et la réception de trames de pause dans les directions de transint et de réception.
NdisPauseFunctionsUnknown
Indique que la négociation de frame de pause est en cours. La prise en charge de l’image de pause que le partenaire de liaison fournit est inconnue.
DataBackFillSize
Taille de remplissage des données requise, en octets, du pilote.
ContextBackFillSize
Taille de remplissage de contexte requise, en octets, du pilote.
SupportedOidList
Liste des OID pris en charge par le pilote miniport. Pour plus d’informations, consultez OID_GEN_SUPPORTED_LIST.
SupportedOidListLength
Taille, en octets, de la liste OID à SupportedOidList .
AutoNegotiationFlags
Paramètres de négociation automatique pour l’adaptateur miniport. Ce membre est créé à partir d’une or au niveau du bit des indicateurs suivants :
NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED
L’adaptateur a négocié automatiquement la vitesse de liaison de transmission avec le partenaire de liaison.
NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED
L’adaptateur a négocié automatiquement la vitesse de liaison de réception avec le partenaire de liaison.
NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED
L’adaptateur a négocié automatiquement l’état duplex avec le partenaire de liaison.
NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED
L’adaptateur a négocié automatiquement les fonctions de pause avec le partenaire de liaison.
PowerManagementCapabilitiesEx
Pointeur vers une structure NDIS_PM_CAPABILITIES. Cette structure spécifie les fonctionnalités de gestion de l’alimentation de l’adaptateur miniport. Ce membre est obligatoire pour les pilotes NDIS 6.20 et ultérieurs.
Remarques
Un pilote miniport passe un pointeur vers une structure de NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES dans le paramètre MiniportAttributes du fonction NdisMSetMiniportAttributes. Un pilote miniport appelle NdisMSetMiniportAttributes à partir de sa fonction MiniportInitializeEx lors de l’initialisation. Les pilotes miniport doivent définir ces attributs après avoir défini les attributs d’inscription dans le NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES structure et avant de définir d’autres attributs. La définition de cet attribut est obligatoire.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge dans NDIS 6.0 et versions ultérieures. |
| d’en-tête | ndis.h (include Ndis.h) |