NDIS_PORT_CHARACTERISTICS structure (ntddndis.h)

Article
03/05/2024

La structure NDIS_PORT_CHARACTERISTICS spécifie les caractéristiques d’un port NDIS. Pour plus d’informations sur les ports NDIS, consultez Ports NDIS.

Syntaxe

typedef struct _NDIS_PORT_CHARACTERISTICS {
  NDIS_OBJECT_HEADER            Header;
  NDIS_PORT_NUMBER              PortNumber;
  ULONG                         Flags;
  NDIS_PORT_TYPE                Type;
  NDIS_MEDIA_CONNECT_STATE      MediaConnectState;
  ULONG64                       XmitLinkSpeed;
  ULONG64                       RcvLinkSpeed;
  NET_IF_DIRECTION_TYPE         Direction;
  NDIS_PORT_CONTROL_STATE       SendControlState;
  NDIS_PORT_CONTROL_STATE       RcvControlState;
  NDIS_PORT_AUTHORIZATION_STATE SendAuthorizationState;
  NDIS_PORT_AUTHORIZATION_STATE RcvAuthorizationState;
} NDIS_PORT_CHARACTERISTICS, *PNDIS_PORT_CHARACTERISTICS;

Membres

Header

Structure NDIS_OBJECT_HEADER de la structure NDIS_PORT_CHARACTERISTICS . Définissez le membre Type de la structure spécifiée par Header sur NDIS_OBJECT_TYPE_DEFAULT, le membre Revision sur NDIS_PORT_CHARACTERISTICS_REVISION_1 et le membre Size sur NDIS_SIZEOF_PORT_CHARACTERISTICS_REVISION_1.

PortNumber

Numéro du port NDIS associé à cette structure NDIS_PORT_CHARACTERISTICS . La valeur PortNumber est une valeur NDIS_PORT_NUMBER, qui a un type de données ULONG et est valide de zéro à 0xffffff, où zéro est réservé au port par défaut.

Flags

Combinaison or au niveau du bit des indicateurs de caractéristiques de port, ou zéro si aucun indicateur n’est défini. Il existe actuellement un indicateur.

Si l’indicateur NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS est défini, NDIS ignore les paramètres d’état d’authentification et utilise l’état d’authentification par défaut à la place. Un pilote miniport peut utiliser cet indicateur pour demander à NDIS d’utiliser les paramètres d’état d’authentification par défaut pour les ports qu’il alloue et active. Si le pilote miniport contrôle le port par défaut, lorsque le pilote miniport active le port par défaut, le pilote peut définir NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS pour activer le port par défaut avec les paramètres d’état d’authentification par défaut.

Type

Type de port NDIS. Pour plus d’informations, consultez Types de ports NDIS. Les valeurs possibles pour ce type sont les suivantes :

NdisPortTypeUndefined

Type de port par défaut.

NdisPortTypeBridge

Réservé pour le système.

NdisPortTypeRasConnection

Une connexion de service d’accès à distance (RAS).

NdisPortType8021xSupplicant

Station sans fil distante associée à un point d’accès sur cet ordinateur hôte.

NdisPortTypeNdisImPlatform

Réservé pour le système.

Note Cette valeur est prise en charge uniquement dans NDIS 6.30 et versions ultérieures.

MediaConnectState

État de la connexion multimédia du port. Cet état est le même que celui de OID_GEN_MEDIA_CONNECT_STATUS_EX Retours OID.

XmitLinkSpeed

Vitesse de liaison de transmission du port en bits par seconde. La valeur -1 dans ce membre indique que la vitesse de la liaison de transmission est inconnue.

RcvLinkSpeed

Vitesse de la liaison de réception du port, en bits par seconde. La valeur -1 dans ce membre indique que la vitesse de la liaison de réception est inconnue.

Direction

Type de direction d’interface réseau NDIS NET_IF_DIRECTION_TYPE .

SendControlState

État de contrôle du port pour les opérations d’envoi. Ce membre doit contenir l’une des valeurs suivantes :

NdisPortControlStateUnknown

L’état de contrôle du port pour les opérations d’envoi est inconnu.

NdisPortControlStateControlled

Le port est dans un état contrôlé pour les opérations d’envoi. Autrement dit, le port nécessite une autorisation.

NdisPortControlStateUncontrol

Le port est dans un état non contrôlé pour les opérations d’envoi. Autrement dit, le port ne nécessite pas d’autorisation.

RcvControlState

État de contrôle du port pour les opérations de réception. Ce membre doit contenir l’une des valeurs suivantes :

NdisPortControlStateUnknown

L’état de contrôle du port pour les opérations de réception est inconnu.

NdisPortControlStateControlled

Le port est dans un état contrôlé pour les opérations de réception (autrement dit, le port nécessite une autorisation), et la valeur dans le membre SendAuthorizationState détermine l’état d’authentification.

NdisPortControlStateUncontrol

Le port est dans un état non contrôlé pour les opérations de réception. Par conséquent, l’authentification ne s’applique pas à ce port.

SendAuthorizationState

État d’autorisation du port pour les opérations d’envoi. Ignorez ce membre si le membre SendControlState est défini sur NdisPortControlStateUncontrol.

SendAuthorizationState doit contenir l’une des valeurs suivantes :

NdisPortAuthorizationUnknown

L’état d’autorisation du port pour les opérations d’envoi est inconnu.

NdisPortAuthorized

Le port est autorisé pour les opérations d’envoi.

NdisPortUnauthorized

Le port n’est pas autorisé pour les opérations d’envoi.

NdisPortReauthorizing

Le port autorise à nouveau les opérations d’envoi.

RcvAuthorizationState

État d’autorisation du port pour les opérations de réception. Ignorez ce membre si le membre RcvControlState est défini sur NdisPortControlStateUncontrol.

RcvAuthorizationState doit contenir l’une des valeurs suivantes :

NdisPortAuthorizationUnknown

L’état d’autorisation du port pour les opérations de réception est inconnu.

NdisPortAuthorized

Le port est autorisé pour les opérations de réception.

NdisPortUnauthorized

Le port n’est pas autorisé pour les opérations de réception.

NdisPortReauthorizing

Le port autorise à nouveau les opérations de réception.

Remarques

La structure NDIS_PORT_CHARACTERISTICS spécifie les caractéristiques d’un port NDIS. Cette structure apparaît dans une liste de caractéristiques de port fournies dans la structure NDIS_PORT_ARRAY utilisée avec l’OID OID_GEN_ENUMERATE_PORTS .

Pour allouer un port NDIS, un pilote initialise une structure NDIS_PORT_CHARACTERISTICS et la transmet à la fonction NdisMAllocatePort . Lorsque NdisMAllocatePort retourne correctement, NDIS définit le membre PortNumber de NDIS_PORT_CHARACTERISTICS sur le numéro de port attribué par NDIS au port.

NDIS utilise une liste liée de ports dans les événements d’activation de port Plug-and-Play (PnP). NDIS utilise la structure NDIS_PORT pour créer une liste liée de ports, et chaque structure NDIS_PORT contient une structure NDIS_PORT_CHARACTERISTICS .