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