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