NDIS_PORT_STATE-Struktur (ntddndis.h)

Die NDIS_PORT_STATE-Struktur gibt die Portstatusinformationen für einen NDIS-Port an.

Syntax

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;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die NDIS_PORT_STATE-Struktur. Legen Sie das Type-Element der Struktur, die Header angibt, auf NDIS_OBJECT_TYPE_ DEFAULT fest, das Revisionselement auf NDIS_PORT_STATE_REVISION_1 und das Size-Element auf NDIS_SIZEOF_PORT_STATE_REVISION_1.

MediaConnectState

Der Medienverbindungsstatus des Ports. Dieser Zustand ist die gleiche Information wie die OID_GEN_MEDIA_CONNECT_STATUS_EX OID gibt zurück.

XmitLinkSpeed

Die Übertragungsverbindungsgeschwindigkeit des Ports in Bits pro Sekunde. Der Wert -1 in diesem Element gibt an, dass die Übertragungslinkgeschwindigkeit unbekannt ist.

RcvLinkSpeed

Die Empfangslinkgeschwindigkeit des Ports in Bits pro Sekunde. Der Wert -1 in diesem Member gibt an, dass die Empfangslinkgeschwindigkeit unbekannt ist.

Direction

Ein NET_IF_DIRECTION_TYPE NDIS-Netzwerkschnittstellenrichtungstyp.

SendControlState

Der aktuelle Steuerungsstatus des Ports für Sendevorgänge. Dieser Member muss einen der folgenden Werte enthalten:

NdisPortControlStateUnknown

Der Steuerungsstatus des Ports für Sendevorgänge ist unbekannt.

NdisPortControlStateControlled

Der Port befindet sich in einem kontrollierten Zustand für Sendevorgänge. Das heißt, der Port erfordert eine Autorisierung.

NdisPortControlStateUncontrolled

Der Port befindet sich in einem unkontrollierten Zustand für Sendevorgänge. Das heißt, der Port erfordert keine Autorisierung.

RcvControlState

Der aktuelle Steuerungsstatus des Ports für Empfangsvorgänge. Dieser Member muss einen der folgenden Werte enthalten:

NdisPortControlStateUnknown

Der Steuerungsstatus des Ports für Empfangsvorgänge ist unbekannt.

NdisPortControlStateControlled

Der Port befindet sich in einem kontrollierten Zustand für Empfangsvorgänge. Das heißt, der Port erfordert eine Autorisierung.

NdisPortControlStateUncontrolled

Der Port befindet sich in einem unkontrollierten Zustand für Empfangsvorgänge. Das heißt, der Port erfordert keine Autorisierung.

SendAuthorizationState

Der aktuelle Autorisierungsstatus des Ports für Sendevorgänge. Ignorieren Sie diesen Member, wenn das SendControlState-Element auf NdisPortControlStateUncontrolled festgelegt ist.

SendAuthorizationState muss einen der folgenden Werte enthalten:

NdisPortAuthorizationUnknown

Der Autorisierungsstatus des Ports für Sendevorgänge ist unbekannt.

NdisPortAuthorized

Der Port ist für Sendevorgänge autorisiert.

NdisPortUnauthorized

Der Port ist nicht für Sendevorgänge autorisiert.

NdisPortReauthorizing

Der Port wird für Sendevorgänge neu autorisiert.

RcvAuthorizationState

Der aktuelle Autorisierungsstatus des Ports für Empfangsvorgänge. Ignorieren Sie diesen Member, wenn das RcvControlState-Element auf NdisPortControlStateUncontrolled festgelegt ist.

RcvAuthorizationState muss einen der folgenden Werte enthalten:

NdisPortAuthorizationUnknown

Der Autorisierungsstatus des Ports für Empfangsvorgänge ist unbekannt.

NdisPortAuthorized

Der Port ist für Empfangsvorgänge autorisiert.

NdisPortUnauthorized

Der Port ist nicht für Empfangsvorgänge autorisiert.

NdisPortReauthorizing

Der Port wird für Empfangsvorgänge neu autorisiert.

Flags

Reserviert für NDIS.

Hinweise

Die NDIS_PORT_STATE-Struktur wird in der NDIS_STATUS_PORT_STATE status Angabe verwendet, um eine Änderung des Zustands eines Ports anzuzeigen, und wird als Reaktion auf eine OID_GEN_PORT_STATE OID-Abfrage verwendet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Kopfzeile	ntddndis.h (include Ndis.h)

Weitere Informationen

NDIS_OBJECT_HEADER

NDIS_STATUS_PORT_STATE

NET_IF_DIRECTION_TYPE

OID_GEN_MEDIA_CONNECT_STATUS_EX

OID_GEN_PORT_STATE