Partilhar via


OID_GEN_LINK_PARAMETERS

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

Informações sobre a versão do

Windows Vista e versões posteriores do Windows
Suportado.

drivers de miniporta NDIS 6.0 e posteriores
Opcional.

A estrutura NDIS_LINK_PARAMETERS é definida do seguinte modo:

    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 estrutura contém os seguintes membros:

Cabeçalho
A estrutura NDIS_OBJECT_HEADER para a estrutura NDIS_LINK_PARAMETERS. Defina o Tipo membro da estrutura que de Cabeçalho especifica para NDIS_OBJECT_TYPE_DEFAULT, o membro de Revisão para NDIS_LINK_PARAMETERS_REVISION_1 e o membro Tamanho para NDIS_SIZEOF_LINK_PARAMETERS_REVISION_1.

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

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 IEEE 802.3. Este membro deve ser uma das seguintes funções de pausa:

NdisPauseFunctions sem suporte
O adaptador ou parceiro de link não suporta quadros de pausa.

NdisPauseFunctionsSendOnly
O adaptador e o parceiro de link suportam apenas o envio de quadros de pausa do adaptador para o parceiro de link.

NdisPauseFunctionsReceiveOnly
O adaptador e o parceiro de link suportam apenas o envio de quadros de pausa do parceiro de link para o adaptador

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

AutoNegotiationFlags
As configurações de negociação automática para o adaptador de miniporta. Este membro é criado a partir de um bit a bit OR das seguintes bandeiras:

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 da miniporta 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 miniporta deve definir a velocidade do link de recebimento para o valor especificado no membro do 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 miniporta deverá definir o estado duplex para 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 de quadro de pausa especificado no membro PauseFunctions.

Comentários

Observação configuração OID_GEN_LINK_PARAMETERS pode causar uma perda de conectividade. Os drivers de miniporta devem reconfigurar o adaptador de miniporta quando esse OID estiver definido. Por exemplo, o driver de miniporta pode redefinir o adaptador de miniporta 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 miniporta mudar devido à solicitação de conjunto de OID_GEN_LINK_PARAMETERS, o driver de miniporta deverá gerar uma indicação de status NDIS_STATUS_LINK_STATE para notificar o NDIS e os drivers sobrepostos sobre o novo estado do link.

Requerimentos

Cabeçalho

Ntddndis.h (inclui Ndis.h)

Ver também

NDIS_OBJECT_HEADER

NDIS_STATUS_LINK_STATE

OID_GEN_MEDIA_DUPLEX_STATE