structure NDIS_PORT_STATE (ntddndis.h)
La structure NDIS_PORT_STATE spécifie les informations d’état du port pour un port NDIS.
Syntaxe
typedef struct _NDIS_PORT_STATE {
NDIS_OBJECT_HEADER Header;
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;
ULONG Flags;
} NDIS_PORT_STATE, *PNDIS_PORT_STATE;
Membres
Header
Structure NDIS_OBJECT_HEADER de la structure NDIS_PORT_STATE. Définissez le membre Type de la structure spécifiée par l’en-tête sur NDIS_OBJECT_TYPE_ DEFAULT, le membre Revision sur NDIS_PORT_STATE_REVISION_1 et le membre Size sur NDIS_SIZEOF_PORT_STATE_REVISION_1.
MediaConnectState
État de la connexion multimédia du port. Cet état est le même que celui de OID_GEN_MEDIA_CONNECT_STATUS_EX OID retourne.
XmitLinkSpeed
Vitesse de liaison de transmission du port, en bits par seconde. La valeur -1 dans ce membre indique que la vitesse du lien de transmission est inconnue.
RcvLinkSpeed
Vitesse de liaison de réception du port, en bits par seconde. La valeur -1 dans ce membre indique que la vitesse de liaison de réception est inconnue.
Direction
Type de direction d’interface réseau NDIS NET_IF_DIRECTION_TYPE .
SendControlState
État de contrôle actuel 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.
NdisPortControlStateControl
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 actuel du 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.
NdisPortControlStateControl
Le port est dans un état contrôlé pour les opérations de réception. Autrement dit, le port nécessite une autorisation.
NdisPortControlStateUncontrol
Le port est dans un état non contrôlé pour les opérations de réception. Autrement dit, le port ne nécessite pas d’autorisation.
SendAuthorizationState
État d’autorisation actuel du port pour les opérations d’envoi. Ignorez ce membre si le membre SendControlState a la valeur 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 actuel 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.
Flags
Réservé à NDIS.
Remarques
La structure de NDIS_PORT_STATE est utilisée dans l’indication status NDIS_STATUS_PORT_STATE pour indiquer une modification de l’état d’un port et est utilisée en réponse à une requête OID OID_GEN_PORT_STATE.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge dans NDIS 6.0 et versions ultérieures. |
| En-tête | ntddndis.h (inclure Ndis.h) |