NDIS_PORT_CHARACTERISTICS struttura (ntddndis.h)

Articolo
08/07/2023

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.

Nota Questo valore è supportato solo in NDIS 6.30 e versioni successive.

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 .