NdisAllocatePacket

9/8/2008

Essa função aloca e inicializa um descritor pacote.

Syntax

VOID NdisAllocatePacket(
  PNDIS_STATUS Status,
  PNDIS_PACKET* Packet,
  NDIS_HANDLE PoolHandle
);

Parameters

• Status
  [out] Ponteiro para uma variável Caller-supplied no qual essa função retorna o status final da solicitação.

• Pacote
  [out]Ponteiro para uma variável Caller-supplied no qual essa função retorna um ponteiro para o descritor alocado pacote.

• PoolHandle
  [no] Identificador retornado por uma acima chamar para o NdisAllocatePacketPool função.

Return Value

A seguinte tabela mostra os valores de retorno para NdisAllocatePacket.

Valor	Descrição
NDIS_STATUS_SUCCESS	O chamador pode utilizar o descritor pacote retornado pelo Pacote parâmetro.
NDIS_STATUS_RESOURCES	A livre lista para o pool pacote tem no momento não disponível entradas. Um chamar subseqüente para o NdisFreePacket função retorna a entrada especificada para o livre lista.

Remarks

Drivers NDIS devem alocar descritores pacote de um pool pacote. Protocolo drivers chamar esta função uma ou mais vezes para suas chamadas subseqüentes para o NdisSend função. Miniports chamar esta função uma ou mais vezes para chamadas subseqüentes para o NdisMIndicateReceivePacket função. NDIS intermediário drivers devem chamar esta função para remontar envia e recebe indicações no atualizado descritores pacote antes de passar de entrada solicitações transferir para outros drivers NDIS.

Cada descritor pacote eventualmente tem um ou mais descritores reserva conectados a ele. Essa função inicializa o descritor pacote em 0 e define seu ponteiro encadear reserva para NULL. O chamador deve encadear os descritores reserva mapeamento dados de pacote para o descritor pacote antes de é enviado ou indicado. A maioria dos drivers NDIS alocar descritores reserva com o NdisAllocateBuffer função.

Drivers devem usar o NDIS_SET_PACKET_XXX As macros para acessar ou configurar nenhum limite - dos - informações banda associado com descritor de pacote.

Requirements

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

See Also

Reference

NDIS_SET_PACKET_HEADER_SIZE
NDIS_SET_PACKET_MEDIA_SPECIFIC_INFO
NDIS_SET_PACKET_STATUS
NDIS_SET_PACKET_TIME_RECEIVED
NDIS_SET_PACKET_TIME_SENT
NDIS_SET_PACKET_TIME_TO_SEND
NdisAllocateBuffer
NdisAllocatePacketPool
NdisAllocateMemory
NdisFreePacket
NdisMEthIndicateReceive
NdisMIndicateReceivePacket
NdisSend