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