estrutura NDIS_LINK_STATE (ntddndis.h)
A estrutura NDIS_LINK_STATE especifica o estado do link atual de um adaptador de miniporta.
Sintaxe
typedef struct _NDIS_LINK_STATE {
NDIS_OBJECT_HEADER Header;
NDIS_MEDIA_CONNECT_STATE MediaConnectState;
NDIS_MEDIA_DUPLEX_STATE MediaDuplexState;
ULONG64 XmitLinkSpeed;
ULONG64 RcvLinkSpeed;
NDIS_SUPPORTED_PAUSE_FUNCTIONS PauseFunctions;
ULONG AutoNegotiationFlags;
} NDIS_LINK_STATE, *PNDIS_LINK_STATE;
Membros
Header
A estrutura NDIS_OBJECT_HEADER para a estrutura NDIS_LINK_STATE . Defina o membro Type da estrutura especificada por Header como NDIS_OBJECT_TYPE_DEFAULT, o membro Revision como NDIS_LINK_STATE_REVISION_1 e o membro Size como NDIS_SIZEOF_LINK_STATE_REVISION_1.
MediaConnectState
O estado de conexão de mídia para o adaptador de miniporta. Para obter mais informações, consulte
OID_GEN_MEDIA_CONNECT_STATUS_EX OID.
MediaDuplexState
O estado duplex de mídia para o adaptador de miniporta. Para obter mais informações, consulte OID_GEN_MEDIA_DUPLEX_STATE OID.
XmitLinkSpeed
A velocidade de link de transmissão atual do adaptador de miniporta em bits por segundo. Para obter mais informações, consulte OID_GEN_LINK_SPEED_EX.
RcvLinkSpeed
A velocidade do link de recebimento atual do adaptador de miniporto em bits por segundo. Para obter mais informações, consulte OID_GEN_LINK_SPEED_EX.
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 de miniporta ou o parceiro de link não dá suporte a quadros de pausa.
NdisPauseFunctionsSendOnly
o adaptador de miniporta e o parceiro de link dão suporte apenas ao envio de quadros de pausa do adaptador de miniporto para o parceiro de link.
NdisPauseFunctionsReceiveOnly
o adaptador de miniporta e o suporte ao parceiro de link só enviam quadros de pausa do parceiro de link para o adaptador de miniporto
NdisPauseFunctionsSendAndReceive
o adaptador de miniporta e o parceiro de link dão suporte ao envio e recebimento de quadros de pausa nas direções de transmissão e recebimento.
NdisPauseFunctionsUnknown
A negociação de quadro de pausa está em andamento. O suporte ao quadro de pausa que o parceiro de link fornece é desconhecido.
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 de miniporta negociou automaticamente a velocidade do link de transmissão com o parceiro de link.
NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED
o adaptador de miniporta negociou automaticamente a velocidade do link de recebimento com o parceiro de link.
NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED
o adaptador de miniporto negociou automaticamente o estado duplex com o parceiro de link.
NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED
o adaptador de miniporta negociou automaticamente as funções de pausa com o parceiro de link.
Comentários
Os drivers de miniporta usam a indicação status NDIS_STATUS_LINK_STATE para notificar o NDIS e os drivers excessivamente que houve uma alteração nas características físicas de um meio.
Quando ele gera essa indicação status, o driver define o membro StatusBuffer da estrutura NDIS_STATUS_INDICATION como um ponteiro para uma estrutura NDIS_LINK_STATE.
O driver de miniporto também retorna uma estrutura NDIS_LINK_STATE quando lida com uma solicitação de consulta OID de OID_GEN_LINK_STATE.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte no NDIS 6.0 e posterior. |
| Cabeçalho | ntddndis.h (inclua Ndis.h) |