OID_GEN_LINK_PARAMETERS

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

Informações sobre versão

Windows Vista e versões posteriores do Windows
Com suporte.

Drivers de miniporta 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:

Cabeçalho
A estrutura NDIS_OBJECT_HEADER para a estrutura NDIS_LINK_PARAMETERS. Defina o membro Type da estrutura especificada por Header como NDIS_OBJECT_TYPE_DEFAULT, o membro Revision como NDIS_LINK_PARAMETERS_REVISION_1 e o membro Size para NDIS_SIZEOF_LINK_PARAMETERS_REVISION_1.

MediaDuplexState
O estado duplex de mídia. Esse valor é o mesmo que o valor retornado pelo OID do 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 miniporta. 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 miniporta deve negociar automaticamente o suporte para quadros de pausa com a outra extremidade. Se esse sinalizador não estiver definido, o driver de miniporta deverá usar o suporte ao quadro de pausa especificado no membro PauseFunctions .

Comentários

Nota Definir OID_GEN_LINK_PARAMETERS pode causar uma perda de conectividade. Os drivers de miniport devem reconfigurar o adaptador de miniporta quando esse OID estiver definido. 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 de conjunto de OID_GEN_LINK_PARAMETERS, o driver de miniporto deverá gerar uma indicação NDIS_STATUS_LINK_STATE status para notificar o NDIS e os drivers sobressociários do novo estado de link.

Requisitos

parâmetro

Ntddndis.h (inclua Ndis.h)

Confira também

NDIS_OBJECT_HEADER

NDIS_STATUS_LINK_STATE

OID_GEN_MEDIA_DUPLEX_STATE