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 de pilote miniport associés à 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 de la structure NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES . Définissez le membre Type de la structure que l’en-tête spécifie sur NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES.
Pour indiquer la version de la structure NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES , définissez le membre Revision 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 Sizesur 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
Type NdisMediumXxx pris en charge par l’adaptateur miniport. Pour plus d’informations, consultez NDIS_MEDIUM.
PhysicalMediumType
Type de support physique de 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 de liaison de transmission maximale de l’adaptateur en bits par seconde. Pour plus d’informations, consultez OID_GEN_MAX_LINK_SPEED.
XmitLinkSpeed
Vitesse de liaison de transmission actuelle de l’adaptateur en bits par seconde. Pour plus d’informations, consultez OID_GEN_LINK_SPEED_EX.
MaxRcvLinkSpeed
Vitesse de liaison de réception maximale 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 la rubrique 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 du lookahead de l’adaptateur miniport. Pour plus d’informations, consultez OID_GEN_CURRENT_LOOKAHEAD.
PowerManagementCapabilities
Fonctionnalités de 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 ne prend pas en charge la gestion de l’alimentation, le pilote miniport doit définir PowerManagementCapabilities sur NULL. Les pilotes NDIS 6.20 et versions ultérieures 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 la rubrique 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 à l’interface réseau NDIS NET_IF_ACCESS_TYPE.
DirectionType
Type de direction d’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ée à n’importe quelle interface de type Ethernet. Pour obtenir la liste des 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 une carte physique.
SupportedStatistics
Statistiques prises en charge.
NDIS_STATISTICS_DIRECTED_FRAMES_RCV_SUPPORTED
Les données du membre ifHCInUcastPkts sont valides .
NDIS_STATISTICS_MULTICAST_FRAMES_RCV_SUPPORTED
Les données du membre ifHCInMulticastPkts de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_BROADCAST_FRAMES_RCV_SUPPORTED
Les données du membre ifHCInBroadcastPkts de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_BYTES_RCV_SUPPORTED
Les données du membre ifHCInOctets de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_RCV_DISCARDS_SUPPORTED
Les données du membre ifInDiscards de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_RCV_ERROR_SUPPORTED
Les données du membre ifInErrors de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_DIRECTED_FRAMES_XMIT_SUPPORTED
Les données du membre ifHCOutUcastPkts de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_MULTICAST_FRAMES_XMIT_SUPPORTED
Les données du membre ifHCOutMulticastPkts de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_BROADCAST_FRAMES_XMIT_SUPPORTED
Les données du membre ifHCOutBroadcastPkts de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_BYTES_XMIT_SUPPORTED
Les données du membre ifHCOutOctets de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_XMIT_ERROR_SUPPORTED
Les données du membre ifOutErrors de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_XMIT_DISCARDS_SUPPORTED
Les données du membre ifOutDiscards de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_DIRECTED_BYTES_RCV_SUPPORTED
Les données du membre ifHCInUcastOctets de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_MULTICAST_BYTES_RCV_SUPPORTED
Les données du membre ifHCInMulticastOctets de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_BROADCAST_BYTES_RCV_SUPPORTED
Les données du membre ifHCInBroadcastOctets de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_DIRECTED_BYTES_XMIT_SUPPORTED
Les données du membre ifHCOutUcastOctets de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_MULTICAST_BYTES_XMIT_SUPPORTED
Les données du membre ifHCOutMulticastOctets de NDIS_STATISTICS_INFO sont valides.
NDIS_STATISTICS_BROADCAST_BYTES_XMIT_SUPPORTED
Les données du membre ifHCOutBroadcastOctets 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 images de pause.
NdisPauseFunctionsSendOnly
Indique que l’adaptateur et le partenaire de liaison prennent uniquement en charge l’envoi d’images 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 d’images de pause à partir du partenaire de liaison vers 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 transmission et de réception.
NdisPauseFunctionsUnknown
Indique que la négociation du cadre de pause est en cours. La prise en charge du cadre de pause fourni par le partenaire de liaison 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 dans SupportedOidList .
AutoNegotiationFlags
Paramètres de négociation automatique de l’adaptateur miniport. Ce membre est créé à partir d’un 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 la 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 la 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 versions ultérieures.
Remarques
Un pilote miniport transmet 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 pendant 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 ces attributs est obligatoire.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge dans NDIS 6.0 et versions ultérieures. |
| En-tête | ndis.h (inclure Ndis.h) |