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 pour la structure NDIS_PORT_STATE. Définissez le membre Type de la structure qui En-tête spécifie NDIS_OBJECT_TYPE_ DEFAULT, le membre Révision sur NDIS_PORT_STATE_REVISION_1 et le membre Taille sur NDIS_SIZEOF_PORT_STATE_REVISION_1.
MediaConnectState
État de connexion multimédia du port. Cet état est les mêmes informations que celles du OID_GEN_MEDIA_CONNECT_STATUS_EX retour d’OID.
XmitLinkSpeed
Vitesse de liaison de transmission du port, en bits par seconde. Une valeur de -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. Une valeur de -1 dans ce membre indique que la vitesse de liaison de réception est inconnue.
Direction
Type de direction de l’interface réseau NDIS NET_IF_DIRECTION_TYPE.
SendControlState
État actuel du 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.
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 est défini sur NdisPortControlStateUncontrolStateUncontrol.
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 a la valeur NdisPortControlStateUncontrolUncontrol.
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 de nouveau les opérations de réception.
Flags
Réservé à NDIS.
Remarques
La structure NDIS_PORT_STATE est utilisée dans l’indication d’état 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge dans NDIS 6.0 et versions ultérieures. |
| d’en-tête | ntddndis.h (include Ndis.h) |