OID_GEN_LINK_PARAMETERS

Como um conjunto, o NDIS e os drivers sobrepostos usam o OID OID_GEN_LINK_PARAMETERS para definir o estado de vínculo atual de um adaptador de miniporto. O driver de miniporto recebe o estado duplex, as velocidades de vínculo e as funções de pausa em uma estrutura NDIS_LINK_PARAMETERS.

informações de versão

Windows Vista e versões posteriores do Windows
Suportado.

drivers de miniporto NDIS 6.0 e posterior
Opcional.

A estrutura NDIS_LINK_PARAMETERS é definida da seguinte maneira:

    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;

Essa estrutura contém os seguintes membros:

de cabeçalho
A estrutura NDIS_OBJECT_HEADER para a estrutura NDIS_LINK_PARAMETERS. Defina o membro tipo da estrutura especificada Header para NDIS_OBJECT_TYPE_DEFAULT, o membro de Revisão de para NDIS_LINK_PARAMETERS_REVISION_1 e o membro tamanho do para NDIS_SIZEOF_LINK_PARAMETERS_REVISION_1.

MediaDuplexState
O estado duplex da mídia. Esse valor é o mesmo que o valor retornado pela OID OID_GEN_MEDIA_DUPLEX_STATE.

XmitLinkSpeed
A velocidade do link de transmissão em bits por segundo.

RcvLinkSpeed
A velocidade do link de recebimento em bits por segundo.

PauseFunctions
O tipo de suporte para os quadros de pausa do IEEE 802.3. Esse membro deve ser uma das seguintes funções de pausa:

NdisPauseFunctionsUnsupported
O adaptador ou parceiro de link não dá suporte a quadros de pausa.

NdisPauseFunctionsSendOnly
O adaptador e o parceiro de link dão suporte apenas ao envio de quadros de pausa do adaptador para o parceiro de link.

NdisPauseFunctionsReceiveOnly
O adaptador e o parceiro de link dão suporte apenas ao envio de quadros de pausa do parceiro de link para o adaptador

NdisPauseFunctionsSendAndReceive
O adaptador e o parceiro de link dão suporte ao envio e ao recebimento de quadros de pausa nas direções de transmissão e recebimento.

AutoNegotiationFlags
As configurações de negociação automática para o adaptador de miniporto. Esse membro é criado a partir de um OR bit a bit dos seguintes sinalizadores:

NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED
O adaptador deve negociar automaticamente a velocidade do link de transmissão com o parceiro de link. Se esse sinalizador não estiver definido, o driver de miniporto deverá definir a velocidade do link de transmissão para o valor especificado no membro XmitLinkSpeed.

NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED
O adaptador deve negociar automaticamente a velocidade do link de recebimento com o parceiro de link. Se esse sinalizador não estiver definido, o driver de miniporto deverá definir a velocidade do link de recebimento para o valor especificado no membro RcvLinkSpeed.

NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED
O adaptador deve negociar automaticamente o estado duplex com o parceiro de link. Se esse sinalizador não estiver definido, o driver de miniporto deverá definir o estado duplex como o valor especificado no membro MediaDuplexState.

NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED
O driver de miniporto deve negociar automaticamente o suporte para quadros de pausa com a outra extremidade. Se esse sinalizador não estiver definido, o driver de miniporto deverá usar o suporte ao quadro de pausa especificado no membro PauseFunctions.

Observações

Observação Configuração OID_GEN_LINK_PARAMETERS pode causar uma perda de conectividade. Os drivers de miniporto devem reconfigurar o adaptador de miniporto quando essa OID for definida. Por exemplo, o driver de miniporto pode redefinir o adaptador de miniporto com a perda resultante de conexões existentes. O mecanismo específico para reconfiguração depende do aplicativo.

Se o estado do link do adaptador de miniporto for alterado devido à solicitação OID_GEN_LINK_PARAMETERS definida, o driver de miniporto deverá gerar uma indicação de status NDIS_STATUS_LINK_STATE para notificar o NDIS e os drivers sobressalente do novo estado de link.

Requisitos

Consulte também

NDIS_OBJECT_HEADER

NDIS_STATUS_LINK_STATE

OID_GEN_MEDIA_DUPLEX_STATE