Compartilhar via


NDIS_LINK_STATE estrutura (ntddndis.h)

A estrutura de NDIS_LINK_STATE especifica o estado de vínculo atual de um adaptador de miniporto.

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 tipo da estrutura que de Cabeçalho especifica para NDIS_OBJECT_TYPE_DEFAULT, o membro de Revisão para NDIS_LINK_STATE_REVISION_1 e o membro tamanho do para NDIS_SIZEOF_LINK_STATE_REVISION_1.

MediaConnectState

O estado de conexão de mídia para o adaptador de miniporto. Para obter mais informações, consulte
OID_GEN_MEDIA_CONNECT_STATUS_EX OID.

MediaDuplexState

O estado duplex de mídia para o adaptador de miniporto. Para obter mais informações, consulte OID_GEN_MEDIA_DUPLEX_STATE OID.

XmitLinkSpeed

A velocidade de link de transmissão atual do adaptador de miniporto em bits por segundo. Para obter mais informações, consulte OID_GEN_LINK_SPEED_EX.

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

RcvLinkSpeed

A velocidade atual do link de recebimento do adaptador de miniporto em bits por segundo. Para obter mais informações, consulte OID_GEN_LINK_SPEED_EX.

Observação 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 miniporto ou parceiro de link não dá suporte a quadros de pausa.

NdisPauseFunctionsSendOnly

o adaptador de miniporto 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 miniporto e o suporte ao parceiro de link apenas enviando quadros de pausa do parceiro de link para o adaptador de miniporto

NdisPauseFunctionsSendAndReceive

o adaptador de miniporto 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.

NdisPauseFunctionsUnknown

A negociação do 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 miniporto. Esse membro é criado a partir de um OR bit a bit dos seguintes sinalizadores:

o adaptador de miniporto negociou automaticamente a velocidade do link de transmissão com o parceiro de link.

o adaptador de miniporto negociou automaticamente a velocidade de vínculo de recebimento com o parceiro de link.

o adaptador de miniporto negociou automaticamente o estado duplex com o parceiro de link.

o adaptador de miniporto negociou automaticamente as funções de pausa com o parceiro de link.

Observações

Os drivers de miniporto usam a indicação de status NDIS_STATUS_LINK_STATE para notificar o NDIS e os drivers sobressaltos de que houve uma alteração nas características físicas de um meio.

Quando ele gera essa indicação de 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
de cliente com suporte mínimo Com suporte no NDIS 6.0 e posterior.
cabeçalho ntddndis.h (inclua Ndis.h)

Consulte também

NDIS_OBJECT_HEADER

NDIS_STATUS_INDICATION

NDIS_STATUS_LINK_STATE

OID_GEN_LINK_SPEED_EX

OID_GEN_LINK_STATE

OID_GEN_MEDIA_CONNECT_STATUS_EX OID_GEN_MEDIA_DUPLEX_STATE