structure NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES (ndis.h)

Article
04/13/2023

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.

Note Les pilotes NDIS 6.0 doivent prendre en charge toutes les statistiques et les signaler lorsque les pilotes sont interrogés pour OID_GEN_STATISTICS.

La valeur est la OR au niveau du bit des indicateurs suivants :

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.