NDIS_PORT_CHARACTERISTICS struttura (ntddndis.h)
La struttura NDIS_PORT_CHARACTERISTICS specifica le caratteristiche di una porta NDIS. Per altre informazioni sulle porte NDIS, vedere Porte NDIS.
Sintassi
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;
Members
Header
Struttura NDIS_OBJECT_HEADER per la struttura NDIS_PORT_CHARACTERISTICS . Impostare il membro Type della struttura specificata da Header su NDIS_OBJECT_TYPE_DEFAULT, il membro Revision su NDIS_PORT_CHARACTERISTICS_REVISION_1 e il membro Size su NDIS_SIZEOF_PORT_CHARACTERISTICS_REVISION_1.
PortNumber
Numero della porta NDIS associata a questa struttura di NDIS_PORT_CHARACTERISTICS . Il valore PortNumber è un valore NDIS_PORT_NUMBER, che ha un tipo di dati ULONG ed è valido da zero a 0xffffff, dove zero è riservato per la porta predefinita.
Flags
Combinazione OR bit per bit dei flag delle caratteristiche della porta o zero se non vengono impostati flag. Esiste attualmente un flag.
Se il flag NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS è impostato, NDIS ignora le impostazioni dello stato di autenticazione e usa invece lo stato di autenticazione predefinito. Un driver miniport può usare questo flag per richiedere che NDIS usi le impostazioni predefinite dello stato di autenticazione per le porte che alloca e attiva. Se il driver miniport controlla la porta predefinita, quando il driver miniport attiva la porta predefinita, il driver può impostare NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS per attivare la porta predefinita con le impostazioni di stato di autenticazione predefinite.
Type
Tipo di porta NDIS. Per altre informazioni, vedere Tipi di porte NDIS. Il tipo può corrispondere a uno dei valori seguenti:
NdisPortTypeUndefined
Tipo di porta predefinito.
NdisPortTypeBridge
Riservato per l'utilizzo nel sistema.
NdisPortTypeRasConnection
Connessione RAS (Remote Access Service).
NdisPortType8021xSupplicant
Stazione wireless remota associata a un punto di accesso nel computer host.
NdisPortTypeNdisImPlatform
Riservato per l'utilizzo nel sistema.
MediaConnectState
Stato della connessione multimediale della porta. Questo stato è la stessa informazione che l'oggetto OID_GEN_MEDIA_CONNECT_STATUS_EX OID restituisce.
XmitLinkSpeed
Velocità del collegamento di trasmissione della porta in bit al secondo. Un valore di -1 in questo membro indica che la velocità del collegamento di trasmissione è sconosciuta.
RcvLinkSpeed
Velocità del collegamento di ricezione della porta, in bit al secondo. Un valore di -1 in questo membro indica che la velocità del collegamento di ricezione è sconosciuta.
Direction
Tipo di direzione dell'interfaccia di rete NDIS NET_IF_DIRECTION_TYPE.
SendControlState
Stato del controllo della porta per le operazioni di invio. Questo membro deve contenere uno dei valori seguenti:
NdisPortControlStateUnknown
Lo stato di controllo della porta per le operazioni di invio è sconosciuto.
NdisPortControlStateControl
La porta si trova in uno stato controllato per le operazioni di invio. Ovvero, la porta richiede l'autorizzazione.
NdisPortControlStateUncontrolUncontrol
La porta si trova in uno stato non controllato per le operazioni di invio. Ovvero, la porta non richiede l'autorizzazione.
RcvControlState
Stato del controllo della porta per le operazioni di ricezione. Questo membro deve contenere uno dei valori seguenti:
NdisPortControlStateUnknown
Lo stato di controllo della porta per le operazioni di ricezione è sconosciuto.
NdisPortControlStateControl
La porta si trova in uno stato controllato per le operazioni di ricezione, ovvero la porta richiede l'autorizzazione, e il valore nel membro SendAuthorizationState determina lo stato di autenticazione.
NdisPortControlStateUncontrolUncontrol
La porta si trova in uno stato non controllato per le operazioni di ricezione. Pertanto, l'autenticazione non si applica a questa porta.
SendAuthorizationState
Stato di autorizzazione della porta per le operazioni di invio. Ignorare questo membro se il membro SendControlState è impostato su NdisPortControlStateUncontrolUncontrol.
SendAuthorizationState deve contenere uno dei valori seguenti:
NdisPortAuthorizationUnknown
Lo stato di autorizzazione della porta per le operazioni di invio è sconosciuto.
NdisPort Non autorizzato
La porta è autorizzata per le operazioni di invio.
NdisPortUn autorizzato
La porta non è autorizzata per le operazioni di invio.
NdisPortReauthorizing
La porta viene rivalutata per le operazioni di invio.
RcvAuthorizationState
Stato di autorizzazione della porta per le operazioni di ricezione. Ignorare questo membro se il membro RcvControlState è impostato su NdisPortControlStateUncontrolUncontrol.
RcvAuthorizationState deve contenere uno dei valori seguenti:
NdisPortAuthorizationUnknown
Lo stato di autorizzazione della porta per le operazioni di ricezione è sconosciuto.
NdisPort Non autorizzato
La porta è autorizzata per le operazioni di ricezione.
NdisPortUn autorizzato
La porta non è autorizzata per le operazioni di ricezione.
NdisPortReauthorizing
La porta viene rivalutata per le operazioni di ricezione.
Commenti
La struttura NDIS_PORT_CHARACTERISTICS specifica le caratteristiche di una porta NDIS. Questa struttura viene visualizzata in un elenco di caratteristiche di porta fornite nella struttura NDIS_PORT_ARRAY usata con l'OID OID_GEN_ENUMERATE_PORTS.
Per allocare una porta NDIS, un driver inizializza una struttura NDIS_PORT_CHARACTERISTICS e lo passa alla funzione NdisMAllocatePort . Quando NdisMAllocatePort restituisce correttamente, NDIS imposta il membro PortNumber di NDIS_PORT_CHARACTERISTICS sul numero di porta assegnato alla porta.
NDIS usa un elenco collegato di porte negli eventi di attivazione della porta Plug and Play (PnP). NDIS usa la struttura NDIS_PORT per creare un elenco collegato di porte e ogni struttura NDIS_PORT contiene una struttura NDIS_PORT_CHARACTERISTICS .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato in NDIS 6.0 e versioni successive. |
| Intestazione | ntddndis.h (include Ndis.h) |