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;
Angehörige
Header
Die NDIS_OBJECT_HEADER Struktur für die NDIS_PORT_CHARACTERISTICS Struktur. Legen Sie das element Type der Struktur fest, das Header- angibt, NDIS_OBJECT_TYPE_DEFAULT, das element Revision auf NDIS_PORT_CHARACTERISTICS_REVISION_1 und das element Size 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 einen ULONG-Datentyp aufweist und von Null bis 0xffffff gültig ist, wobei Null für den Standardport reserviert ist.
Flags
Eine bitweise OR-Kombination der Porteigenschaftenkennzeichnungen oder Null, wenn keine Flags festgelegt sind. Zurzeit gibt es ein Flag.
Wenn das NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS Flag festgelegt ist, ignoriert NDIS die Authentifizierungsstatuseinstellungen und verwendet stattdessen den Standardauthentifizierungsstatus. Ein Miniporttreiber kann dieses Flag verwenden, um anzufordern, dass NDIS die Standardauthentifizierungsstatuseinstellungen für die Ports verwendet, die er zuordnet und aktiviert. Wenn der Miniporttreiber den Standardport steuert, kann der Treiber, wenn der Miniporttreiber den Standardport aktiviert, NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS festlegen, um den Standardport mit den Standardauthentifizierungsstatuseinstellungen zu aktivieren.
Type
Der Typ des NDIS-Ports. Weitere Informationen finden Sie unter Typen von NDIS-Ports. Dieser Typ kann einer der folgenden Werte sein:
NdisPortTypeUndefined
Der Standardporttyp.
NdisPortTypeBridge
Reserviert für die Systemverwendung.
NdisPortTypeRasConnection
Eine RAS-Verbindung (Remote Access Service).
NdisPortType8021xSupplicant
Eine Drahtlose Remotestation, die einem Zugriffspunkt auf diesem Hostcomputer zugeordnet ist.
NdisPortTypeNdisImPlatform
Reserviert für die Systemverwendung.
MediaConnectState
Der Medienverbindungsstatus des Ports. Dieser Zustand ist die gleichen Informationen wie die OID_GEN_MEDIA_CONNECT_STATUS_EX OID wird zurückgegeben.
XmitLinkSpeed
Die Übertragungsverbindungsgeschwindigkeit des Ports in Bits pro Sekunde. Ein Wert von -1 in diesem Element gibt an, dass die Übertragungsverbindungsgeschwindigkeit unbekannt ist.
RcvLinkSpeed
Die Empfangsverbindungsgeschwindigkeit des Ports in Bits pro Sekunde. Ein Wert von -1 in diesem Element gibt an, dass die Empfangslinkgeschwindigkeit unbekannt ist.
Direction
Ein NET_IF_DIRECTION_TYPE NDIS-Netzwerkschnittstellenrichtungstyp.
SendControlState
Der Kontrollstatus des Ports für Sendevorgänge. Dieses Element muss einen der folgenden Werte enthalten:
NdisPortControlStateUnknown
Der Kontrollstatus des Ports für Sendevorgänge ist unbekannt.
NdisPortControlStateControlled
Der Port befindet sich in einem kontrollierten Zustand für Sendevorgänge. Das heißt, für den Port ist eine Autorisierung erforderlich.
NdisPortControlStateUncontrolled
Der Port befindet sich in einem unkontrollierten Zustand für Sendevorgänge. Das heißt, der Port erfordert keine Autorisierung.
RcvControlState
Der Kontrollstatus des Ports für Empfangsvorgänge. Dieses Element muss einen der folgenden Werte enthalten:
NdisPortControlStateUnknown
Der Kontrollstatus 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 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. Dieses Element ignorieren, wenn der SendControlState- Member auf NdisPortControlStateUncontrolledfestgelegt 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 dieses Element, wenn das RcvControlState Member auf NdisPortControlStateUncontrolledfestgelegt 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.
Bemerkungen
Die NDIS_PORT_CHARACTERISTICS Struktur gibt die Merkmale eines NDIS-Ports an. Diese Struktur wird in einer Liste der Porteigenschaften angezeigt, die in der NDIS_PORT_ARRAY Struktur bereitgestellt werden, die mit dem OID_GEN_ENUMERATE_PORTS OID verwendet wird.
Um einen NDIS-Port zuzuweisen, initialisiert ein Treiber eine NDIS_PORT_CHARACTERISTICS Struktur und übergibt ihn an die NdisMAllocatePort--Funktion. Wenn NdisMAllocatePort erfolgreich zurückgegeben, 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 der Ports in Plug- und Play-Ereignissen (Port Activation Plug and Play, PnP). 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 |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Header- | ntddndis.h (include Ndis.h) |