OID_GEN_LINK_PARAMETERS

Como conjunto, los controladores NDIS y los controladores de exceso usan el OID de OID_GEN_LINK_PARAMETERS para establecer el estado de vínculo actual de un adaptador de minipuerto. El controlador de minipuerto recibe el estado dúplex, las velocidades de vínculo y las funciones de pausa en una estructura de NDIS_LINK_PARAMETERS.

Información de versión

Windows Vista y versiones posteriores de Windows
Compatible.

Controladores de miniporte NDIS 6.0 y versiones posteriores
Opcional.

La estructura NDIS_LINK_PARAMETERS se define de la siguiente manera:

    typedef struct _NDIS_LINK_PARAMETERS {
         NDIS_OBJECT_HEADER Header;
         NDIS_MEDIA_DUPLEX_STATE MediaDuplexState;
         ULONG64 XmitLinkSpeed;
         ULONG64 RcvLinkSpeed;
         NDIS_SUPPORTED_PAUSE_FUNCTIONS PauseFunctions;
         ULONG AutoNegotiationFlags;
    } NDIS_LINK_PARAMETERS, *PNDIS_LINK_PARAMETERS;

Esta estructura contiene los siguientes miembros:

Rúbrica
Estructura NDIS_OBJECT_HEADER de la estructura NDIS_LINK_PARAMETERS. Establezca el miembro Type de la estructura que Header especifica para NDIS_OBJECT_TYPE_DEFAULT, el miembro Revision en NDIS_LINK_PARAMETERS_REVISION_1 y el miembro Size en NDIS_SIZEOF_LINK_PARAMETERS_REVISION_1.

MediaDuplexState
Estado dúplex multimedia. Este valor es el mismo que el valor devuelto por el OID de OID_GEN_MEDIA_DUPLEX_STATE .

XmitLinkSpeed
Velocidad del vínculo de transmisión en bits por segundo.

RcvLinkSpeed
Velocidad del vínculo de recepción en bits por segundo.

PauseFunctions
El tipo de compatibilidad con los fotogramas de pausa IEEE 802.3. Este miembro debe ser una de las siguientes funciones de pausa:

NdisPauseFunctionsUnsupported
El adaptador o asociado de vínculo no admite fotogramas de pausa.

NdisPauseFunctionsSendOnly
El adaptador y el asociado de vínculo solo admiten el envío de fotogramas de pausa desde el adaptador al asociado de vínculo.

NdisPauseFunctionsReceiveOnly
El adaptador y el asociado de vínculo solo admiten el envío de fotogramas de pausa desde el asociado de vínculo al adaptador.

NdisPauseFunctionsSendAndReceive
El adaptador y el asociado de vínculo admiten el envío y recepción de fotogramas de pausa en las instrucciones de transmisión y recepción.

AutoNegotiationFlags
La configuración de negociación automática para el adaptador de minipuerto. Este miembro se crea a partir de un OR bit a bit de las marcas siguientes:

NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED
El adaptador debe negociar automáticamente la velocidad del enlace de transmisión con el asociado de vínculo. Si no se establece esta marca, el controlador de minipuerto debe establecer la velocidad del vínculo de transmisión en el valor especificado en el miembro XmitLinkSpeed .

NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED
El adaptador debe negociar automáticamente la velocidad del vínculo de recepción con el asociado de vínculo. Si no se establece esta marca, el controlador de minipuerto debe establecer la velocidad del vínculo de recepción en el valor especificado en el miembro RcvLinkSpeed .

NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED
El adaptador debe negociar automáticamente el estado dúplex con el asociado de vínculo. Si no se establece esta marca, el controlador de minipuerto debe establecer el estado dúplex en el valor especificado en el miembro MediaDuplexState .

NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED
El controlador de minipuerto debe negociar automáticamente la compatibilidad con fotogramas de pausa con el otro extremo. Si no se establece esta marca, el controlador de minipuerto debe usar la compatibilidad con fotogramas de pausa especificada en el miembro PauseFunctions .

Observaciones

Nota Establecer OID_GEN_LINK_PARAMETERS puede provocar una pérdida de conectividad. Los controladores de minipuerto deben volver a configurar el adaptador de minipuerto cuando se establece este OID. Por ejemplo, el controlador de minipuerto puede restablecer el adaptador de miniporte con la pérdida resultante de conexiones existentes. El mecanismo específico para la reconfiguración depende de la aplicación.

Si el estado del vínculo del adaptador de minipuerto cambia debido a la solicitud establecida de OID_GEN_LINK_PARAMETERS, el controlador de miniporte debe generar una indicación de estado de NDIS_STATUS_LINK_STATE para notificar a NDIS y a los controladores de exceso del nuevo estado del vínculo.

Requisitos

Encabezado

Ntddndis.h (include Ndis.h)

Consulte también

NDIS_OBJECT_HEADER

NDIS_STATUS_LINK_STATE

OID_GEN_MEDIA_DUPLEX_STATE