NdisMWanIndicateReceive

9/8/2008

Essa função notifica adaptador que um pacote foi recebida para um link estabelecida seja encaminhado para o apropriado ligado driver protocolo.

Syntax

VOID NdisMWanIndicateReceive(
  PNDIS_STATUS Status,
  NDIS_HANDLE MiniportAdapterHandle,
  NDIS_HANDLE NdisLinkContext,
  PUCHAR PacketBuffer,
  UINT PacketSize
);

Parameters

• Status
  [out] Aponta para uma variável Caller-supplied no qual essa função retorna o status da indicação, que pode ser uma do seguinte:

  • NDIS_STATUS_SUCCESS
    Adaptador reconhecida e aceita o pacote.
  • NDIS_STATUS_NOT_ACCEPTED
    Adaptador não reconheceu o quadro.

  Qualquer outro status indica que adaptador reconhecido o quadro, mas por algum motivo não foi possível aceitá-lo.

• MiniportAdapterHandle
  [no] Especifica o identificador originalmente entrada para MiniportInitialize.

• NdisLinkContext
  [no] Especifica o identificador fornecido pelo adaptador in a NDIS_MAC_LINE_UP estrutura ao chamar inicial de miniporta para NdisMIndicateStatus Para esse link.

• PacketBuffer
  [no] Especifica o endereço virtual de base da reserva que contém o pacote recebido.

• PacketSize
  [no] Especifica o tamanho em bytes de dados de pacote recebido.

Return Value

Nenhum.

Remarks

Quando uma miniporta chamadas NdisMWanIndicateReceiveAdaptador, indica o pacote por chamado de ProtocolReceive funções de ligado drivers protocolo. O pacote inteiro é disponível para a inspeção por protocolos, como rede de longa distância (WAN) miniportas nunca indicam pacotes parciais com apenas uma parte visão antecipada de dados de pacote.

Conseqüentemente, tal um protocolo será nunca chamar NdisTransferData Portanto, o subjacente driver de miniporta precisa não MiniportTransferData função. A miniporta sempre passa até um pacote toda devido a compactação e criptografia que pode ser aplicada ao pacote a partir de nó transmissor. Além disso, como o link é ponto a ponto, at least um protocolo de nível mais alto aceita cada pacote recebido.

Para qualquer protocolo que recebe uma indicação através NdisMWanIndicateReceive, a reserva em PacketBuffer é válido somente durante a atual chamar a sua ProtocolReceive função. Porque o pacote pode ser compactada, o pacote todo deve estar disponível quando essa chamar é feita. Esta reserva deve conter o mesmo dados e tamanho como a reserva enviada pelo driver no remoto nó.

Os dados contidos o cabeçalho é o mesmo que que recebeu no NIC. Um rede de longa distância (WAN) miniporta não precisa remover qualquer cabeçalhos ou marcadores a partir de dados recebe sua NIC. O driver de transmissão não adicionar preenchimento para o pacote.

Requirements

Header	ndis.h
Library	ndis.dll
Windows Embedded CE	Windows CE .NET 4.0 and later

See Also

Reference

MiniportInitialize
MiniportTransferData
NDIS_MAC_LINE_UP
MiniportSetInformation
NdisTransferData
ProtocolReceive