NDIS_WAN_LINE_UP

9/8/2008

Esta mensagem é usada para indicar um status fila.

Syntax

typedef struct _NDIS_WAN_LINE_UP {
  ULONG LinkSpeed;
  ULONG MaximumTotalSize;
  NDIS_WAN_QUALITY Quality;
  USHORT SendWindow;
  UCHAR RemoteAddress[6];
  UCHAR LocalAddress[6];
  ULONG ProtocolBufferLength;
  PUCHAR ProtocolBuffer;
  USHORT ProtocolType;
  NDIS_STRING DeviceName;
} NDIS_WAN_LINE_UP, *PNDIS_WAN_LINE_UP;

Parameters

• LinkSpeed
  Especifica a velocidade do link, em unidades de 100 bps. Zero não indica nenhuma alteração a partir de velocidade retornada quando chamado de protocolo NdisRequest Com OID_GEN_LINK_SPEED.

• MaximumTotalSize
  Especifica o número máximo de bytes por pacote que o protocolo pode enviar sobre a rede. Zero não indica nenhuma alteração do valor retornado quando chamado de protocolo NdisRequest Com OID_GEN_MAXIMUM_TOTAL_SIZE.

• Qualidade
  Reservado para uso futuro.

• SendWindow
  Especifica o subjacente rede de longa distância (WAN) janela Enviar do rede interface cartão (NIC) driver, que é efetivamente seu limite em pendente enviar pacotes ele irá identificador para este link. Após enviar este número de pacotes para MiniportWanSendAdaptador, armazenará de entrada envia envia enfileirado até que o driver conclui uma pendente.

• RemoteAddress
  Representa o endereço do remoto nó sobre o link na Ethernet-formato estilo. ADAPTADOR fornece esse valor.

• LocalAddress
  Representa o contexto Protocol-determined para indicações sobre este link na Ethernet-formato estilo. Adaptador reserva a alta duas-bytes ordem para seu próprio uso; o protocolo deve definida o restante para tudo o que deve ser o parâmetro de entrada para este link para seu ProtocolReceive e ProtocolStatus funções daí em diante.

• ProtocolBufferLength
  Especifica o número de bytes na reserva em ProtocolBuffer.

• ProtocolBuffer
  Aponta para uma reserva, alocada pelo adaptador, contendo informações Protocol-specific fornecidas por um componente de nível mais alto que faz conexões pelo adaptador para o apropriado protocolos. De exemplo, esta reserva conterá um endereço IP se o protocolo destino for IP ou um número rede IPX se o protocolo destino é IPX. Adaptador libera esta reserva quando o protocolo destino retorna controle de indicação de fila.

• ProtocolType
  Especifica o tipo Ether atribuído do protocolo.

• DeviceName
  Especifica o nome da ligação como um seqüência de caracteres de contagem no sistema-conjunto de caracteres usar como padrão. Windows Embedded CE baseado em drivers, este seqüência de caracteres contém caracteres Unicode. Esta seqüência de caracteres podem ter no máximo 64 caracteres.

Return Value

Nenhum.

Remarks

Quando um rede de longa distância (WAN) de miniporta chamadas NdisMIndicateStatus Com uma indicação fila, adaptador encaminha a indicação para protocolos interessados, formatado nessa estrutura. Na indicação fila inicial para um determinado link, o protocolo deve salvar qualquer estado necessário para as comunicações subseqüentes no link, incluindo fila possível, Line-Down e indicações de fragmento.

Posteriormente, o protocolo pode usar o SendWindow valor como seu limite superior no número de chamadas ele faz para NdisSend Para esse link antes de protocolo regains a propriedade de pelo menos um dos pacotes ele enviado para baixo para o subjacente rede de longa distância (WAN) NIC driver. Algumas placas de rede atingir uma taxa de transferência mais alta se eles tiverem vários pacotes para enviar ao mesmo tempo. Outras pessoas podem se tornar não confiável se seus drivers forem inundadas com envia pacotes. Adaptador também usa a miniporta-conjunto SendWindow valor dessa maneira.

Adaptador Ethernet usa-formato endereço estilo para se comunicar com os protocolos, portanto, o RemoteAddress e LocalAddress Os parâmetros são 6 - byte endereços e são usados como segue:

• Adaptador usa RemoteAddress Para designar um link específico-protocolo contexto. Na indicação fila inicial para um link, o protocolo deve salvar a RemoteAddress valor fornecido pelo adaptador. Posteriormente, o protocolo passa a RemoteAddress valor para adaptador em chamadas para NdisSend Para as transmissões nesse link.
• Usa a protocolo LocalAddress Para configurar o contexto para si na baixa-(4 bytes ordem& LocalAddress [2]) quando ele recebe a indicação fila inicial para um link que está sendo estabelecida. Posteriormente, adaptador passa a LocalAddress valor para o protocolo no indicações de recebimento e status. No efeito, adaptador usa a determinado LocalAddress valor como o destino para de entrada recebe e status indicações sobre o link daí em diante.

O DeviceName parâmetro é usado com pilhas no qual um inferior-nível protocolo possui uma única ligação ao adaptador, mas várias ligações entre ele e um protocolo de nível mais alto na pilha e esse membro pode ser usado para suporte Plug and Play futuras cenários. Ou seja, DeviceName Seria usado por nenhum do seguinte:

• Para identificar a ligação (in) para que um protocolo inferior deve propagar a indicação fila é fornecido pelo adaptador.
• Em um ambiente Plug and Play, para relatório voltar (OUT) ao adaptador o nome de uma ligação recém-criada definido backup por um protocolo inferior em uma indicação fila.

Requirements

Header	ndis.h
Windows Embedded CE	Windows CE 3.0 and later

See Also

Reference

MiniportWanSend
NdisMIndicateStatus
NdisRequest
NdisSend
ProtocolReceive
ProtocolStatus