estrutura NDIS_LINK_STATE (ntddndis.h)

Artigo
02/29/2024

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.

Nota Um valor de NDIS_LINK_SPEED_UNKNOWN indica que a velocidade do link de transmissão é desconhecida.

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.

Nota Um valor de NDIS_LINK_SPEED_UNKNOWN indica que a velocidade do link de recebimento é desconhecida.

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.