Freigeben über


NDIS_PORT_CHARACTERISTICS-Struktur (ntddndis.h)

Die NDIS_PORT_CHARACTERISTICS-Struktur gibt die Merkmale eines NDIS-Ports an. Weitere Informationen zu NDIS-Ports finden Sie unter NDIS-Ports.

Syntax

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;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die NDIS_PORT_CHARACTERISTICS-Struktur . Legen Sie das Type-Element der Struktur, die Header angibt, auf NDIS_OBJECT_TYPE_DEFAULT fest, das Revisionselement auf NDIS_PORT_CHARACTERISTICS_REVISION_1 und das Size-Element auf NDIS_SIZEOF_PORT_CHARACTERISTICS_REVISION_1.

PortNumber

Die Nummer des NDIS-Ports, der dieser NDIS_PORT_CHARACTERISTICS-Struktur zugeordnet ist. Der PortNumber-Wert ist ein NDIS_PORT_NUMBER Wert, der über einen ULONG-Datentyp verfügt und von 0 bis 0xffffff gültig ist, wobei null für den Standardport reserviert ist.

Flags

Eine bitweise OR-Kombination der Porteigenschaftenflags oder null, wenn keine Flags festgelegt sind. Derzeit gibt es ein Flag.

Wenn das flag NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS festgelegt ist, ignoriert NDIS die Einstellungen für den Authentifizierungsstatus und verwendet stattdessen den Standardauthentifizierungsstatus. Ein Miniporttreiber kann dieses Flag verwenden, um anzufordern, dass NDIS die Standardeinstellungen für den Authentifizierungsstatus für die Ports verwendet, die er ordnet und aktiviert. Wenn der Miniporttreiber den Standardport steuert und der Miniporttreiber den Standardport aktiviert, kann der Treiber NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS festlegen, um den Standardport mit den Standardstatuseinstellungen für die Authentifizierung zu aktivieren.

Type

Der Typ des NDIS-Ports. Weitere Informationen finden Sie unter Typen von NDIS-Ports. Dieser Typ kann folgende Werte besitzen:

NdisPortTypeUndefined

Der Standardporttyp.

NdisPortTypeBridge

Ist für das System reserviert.

NdisPortTypeRasConnection

Eine RAS-Verbindung (RAS).

NdisPortType8021xSupplicant

Eine drahtlose Remotestation, die einem Zugriffspunkt auf diesem Hostcomputer zugeordnet ist.

NdisPortTypeNdisImPlatform

Ist für das System reserviert.

Hinweis Dieser Wert wird nur in NDIS 6.30 und höher unterstützt.
 

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 Übertragungslinkgeschwindigkeit 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 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 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 (d. h. der Port erfordert eine Autorisierung), und der Wert im SendAuthorizationState-Member bestimmt den Authentifizierungsstatus.

NdisPortControlStateUncontrolled

Der Port befindet sich in einem unkontrollierten Zustand für Empfangsvorgänge. Daher gilt die Authentifizierung nicht für diesen Port.

SendAuthorizationState

Der 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 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.

Hinweise

Die NDIS_PORT_CHARACTERISTICS-Struktur gibt die Merkmale eines NDIS-Ports an. Diese Struktur wird in einer Liste der Portmerkmale angezeigt, die in der NDIS_PORT_ARRAY-Struktur bereitgestellt werden, die mit der OID_GEN_ENUMERATE_PORTS OID verwendet wird.

Um einen NDIS-Port zuzuweisen, initialisiert ein Treiber eine NDIS_PORT_CHARACTERISTICS-Struktur und übergibt sie an die NdisMAllocatePort-Funktion . Wenn NdisMAllocatePort erfolgreich zurückgegeben wird, legt NDIS den PortNumber-Member von NDIS_PORT_CHARACTERISTICS auf die Portnummer fest, die NDIS dem Port zugewiesen hat.

NDIS verwendet eine verknüpfte Liste von Ports in PnP-Ereignissen (Portaktivierung Plug & Play). NDIS verwendet die NDIS_PORT-Struktur , um eine verknüpfte Liste von Ports zu erstellen, und jede NDIS_PORT-Struktur enthält eine NDIS_PORT_CHARACTERISTICS-Struktur .

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-Ports

NDIS_OBJECT_HEADER

NDIS_PORT

NDIS_PORT_ARRAY

NET_IF_DIRECTION_TYPE

NdisMAllocatePort

OID_GEN_ENUMERATE_PORTS

OID_GEN_MEDIA_CONNECT_STATUS_EX

Typen von NDIS-Ports