Compartir a través de


estructura NDIS_PORT_CHARACTERISTICS (ntddndis.h)

La estructura NDIS_PORT_CHARACTERISTICS especifica las características de un puerto NDIS. Para obtener más información sobre los puertos NDIS, consulte Puertos NDIS.

Sintaxis

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;

Miembros

Header

Estructura NDIS_OBJECT_HEADER de la estructura NDIS_PORT_CHARACTERISTICS . Establezca el miembro Type de la estructura que Header especifica para NDIS_OBJECT_TYPE_DEFAULT, el miembro Revision en NDIS_PORT_CHARACTERISTICS_REVISION_1 y el miembro Size en NDIS_SIZEOF_PORT_CHARACTERISTICS_REVISION_1.

PortNumber

Número del puerto NDIS asociado a esta estructura de NDIS_PORT_CHARACTERISTICS . El valor PortNumber es un valor de NDIS_PORT_NUMBER, que tiene un tipo de datos ULONG y es válido de cero a 0xffffff, donde cero está reservado para el puerto predeterminado.

Flags

Combinación OR bit a bit de las marcas de características del puerto o cero si no se establece ninguna marca. Actualmente hay una marca.

Si se establece la marca de NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS, NDIS omite la configuración del estado de autenticación y usa el estado de autenticación predeterminado en su lugar. Un controlador de minipuerto puede usar esta marca para solicitar que NDIS use la configuración de estado de autenticación predeterminada para los puertos que asigna y activa. Si el controlador de minipuerto controla el puerto predeterminado, cuando el controlador de minipuerto activa el puerto predeterminado, el controlador puede establecer NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS para activar el puerto predeterminado con la configuración de estado de autenticación predeterminada.

Type

Tipo de puerto NDIS. Para obtener más información, vea Tipos de puertos NDIS. Este tipo puede tener uno de los siguientes valores:

NdisPortTypeUndefined

Tipo de puerto predeterminado.

NdisPortTypeBridge

Reservado para uso del sistema.

NdisPortTypeRasConnection

Una conexión de Servicio de acceso remoto (RAS).

NdisPortType8021xSupplicant

Una estación inalámbrica remota asociada a un punto de acceso en este equipo host.

NdisPortTypeNdisImPlatform

Reservado para uso del sistema.

Nota Este valor solo se admite en NDIS 6.30 y versiones posteriores.
 

MediaConnectState

Estado de conexión multimedia del puerto. Este estado es la misma información que el OID_GEN_MEDIA_CONNECT_STATUS_EX Devuelve el OID.

XmitLinkSpeed

Velocidad de enlace de transmisión del puerto en bits por segundo. Un valor de -1 en este miembro indica que se desconoce la velocidad del vínculo de transmisión.

RcvLinkSpeed

Velocidad del vínculo de recepción del puerto, en bits por segundo. Un valor de -1 en este miembro indica que se desconoce la velocidad del vínculo de recepción.

Direction

Un NET_IF_DIRECTION_TYPE tipo de dirección de la interfaz de red NDIS.

SendControlState

Estado de control del puerto para las operaciones de envío. Este miembro debe contener uno de los siguientes valores:

NdisPortControlStateUnknown

El estado de control del puerto para las operaciones de envío es desconocido.

NdisPortControlStateControl

El puerto está en un estado controlado para las operaciones de envío. Es decir, el puerto requiere autorización.

NdisPortControlStateUncontrol

El puerto está en un estado no controlado para las operaciones de envío. Es decir, el puerto no requiere autorización.

RcvControlState

Estado de control del puerto para las operaciones de recepción. Este miembro debe contener uno de los siguientes valores:

NdisPortControlStateUnknown

El estado de control del puerto para las operaciones de recepción es desconocido.

NdisPortControlStateControl

El puerto está en un estado controlado para las operaciones de recepción (es decir, el puerto requiere autorización) y el valor del miembro SendAuthorizationState determina el estado de autenticación.

NdisPortControlStateUncontrol

El puerto está en un estado no controlado para las operaciones de recepción. Por lo tanto, la autenticación no se aplica a este puerto.

SendAuthorizationState

Estado de autorización del puerto para las operaciones de envío. Omita este miembro si el miembro SendControlState está establecido en NdisPortControlStateUncontrol.

SendAuthorizationState debe contener uno de los siguientes valores:

NdisPortAuthorizationUnknown

El estado de autorización del puerto para las operaciones de envío es desconocido.

NdisPortAuthorized

El puerto está autorizado para las operaciones de envío.

NdisPortUnauthorized

El puerto no está autorizado para las operaciones de envío.

NdisPortReauthorizing

El puerto se vuelve a autorizar para las operaciones de envío.

RcvAuthorizationState

Estado de autorización del puerto para las operaciones de recepción. Omita este miembro si el miembro RcvControlState está establecido en NdisPortControlStateUncontrol.

RcvAuthorizationState debe contener uno de los siguientes valores:

NdisPortAuthorizationUnknown

El estado de autorización del puerto para las operaciones de recepción es desconocido.

NdisPortAuthorized

El puerto está autorizado para las operaciones de recepción.

NdisPortUnauthorized

El puerto no está autorizado para las operaciones de recepción.

NdisPortReauthorizing

El puerto se vuelve a autorizar para las operaciones de recepción.

Comentarios

La estructura NDIS_PORT_CHARACTERISTICS especifica las características de un puerto NDIS. Esta estructura aparece en una lista de características de puerto que se proporcionan en la estructura de NDIS_PORT_ARRAY que se usa con el OID de OID_GEN_ENUMERATE_PORTS .

Para asignar un puerto NDIS, un controlador inicializa una estructura de NDIS_PORT_CHARACTERISTICS y la pasa a la función NdisMAllocatePort . Cuando NdisMAllocatePort devuelve correctamente, NDIS establece el miembro PortNumber de NDIS_PORT_CHARACTERISTICS en el número de puerto asignado al puerto.

NDIS usa una lista vinculada de puertos en eventos de Plug and Play de activación de puertos (PnP). NDIS usa la estructura de NDIS_PORT para crear una lista vinculada de puertos y cada estructura de NDIS_PORT contiene una estructura de NDIS_PORT_CHARACTERISTICS .

Requisitos

Requisito Value
Cliente mínimo compatible Compatible con NDIS 6.0 y versiones posteriores.
Encabezado ntddndis.h (include Ndis.h)

Consulte también

Puertos NDIS

NDIS_OBJECT_HEADER

NDIS_PORT

NDIS_PORT_ARRAY

NET_IF_DIRECTION_TYPE

NdisMAllocatePort

OID_GEN_ENUMERATE_PORTS

OID_GEN_MEDIA_CONNECT_STATUS_EX

Tipos de puertos NDIS