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