NdisGetFirstBufferFromPacketSafe

9/8/2008

NdisGetFirstBufferFromPacketSafe Retorna os ponteiros para a reserva descritor e de base virtual endereço para a primeira reserva conectada a um descritor determinado pacote, along with o tamanho de reserva a primeira e a reserva total.

Syntax

VOID  NdisGetFirstBufferFromPacketSafe(
  PNDIS_PACKET Packet,
  PNDIS_BUFFER* FirstBuffer,
  PVOID* FirstBufferVA,
  PUINT FirstBufferLength,
  PUINT TotalBufferLength,
  MM_PAGE_PRIORITY Priority
);

Parameters

• Pacote
  [no] Ponteiro para o descritor pacote do qual esta macro extrai informações sobre a reserva inicial.

• FirstBuffer
  [out] Ponteiro para uma variável Caller-supplied no qual essa macro retorna o endereço do descritor de reserva inicial encadeada para o descritor determinado pacote.

• FirstBufferVA
  [out] Ponteiro para uma variável Caller-supplied no qual essa macro retorna o endereço virtual de base da reserva inicial associado com o pacote. Se NdisGetFirstBufferFromPacketSafe falhar, ele define FirstBufferVA para NULL.

• FirstBufferLength
  [out] Ponteiro para uma variável Caller-supplied no qual essa macro retorna o número de bytes mapeadas pelo descritor de reserva inicial encadeada para o descritor pacote.

• TotalBufferLength
  [out] Ponteiro para uma variável Caller-supplied no qual essa macro retorna o número total de bytes mapeadas por todos os descritores reserva encadeadas para o descritor pacote.

• Prioridade
  [no] Indica a prioridade da solicitação como um do seguinte:

  • LowPagePriority
    Especifica uma prioridade baixa. Ele é aceitável para NdisGetFirstBufferFromPacketSafe Falha se recursos sistema estiverem baixos.
  • NormalPagePriority
    Especifica uma prioridade normal. Ele é aceitável para NdisGetFirstBufferFromPacketSafe Falha se recursos sistema estiverem baixos.
  • HighPagePriority
    Especifica uma prioridade alta. Ele é inaceitável para NdisGetFirstBufferFromPacketSafe FALHA a menos que recursos sistema estão esgotados.

Return Value

Nenhum.

Remarks

NdisGetFirstBufferFromPacketSafe é a versão segura do NdisGetFirstBufferFromPacket. Ao contrário NdisGetFirstBufferFromPacket, NdisGetFirstBufferFromPacketSafe Não não causar verificar um bug se recursos sistema estiver baixa ou esgotado. Drivers devem chamar NdisGetFirstBufferFromPacketSafe em vez de NdisGetFirstBufferFromPacket. Drivers NDIS 5.1 devem chamar NdisGetFirstBufferFromPacketSafe em vez de NdisGetFirstBufferFromPacket.

Chamar drivers NdisGetFirstBufferFromPacketSafe Para informações get sobre a reserva inicial e quantidade de dados associado com um determinado pacote mais rápido do que eles podem fazendo chamadas para NdisQueryPacket e, então, NdisQueryBuffer(Seguro).

Requirements

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

See Also

Reference

MiniportSend
MiniportSendPackets
NdisGetFirstBufferFromPacket
NdisGetNextBuffer
NDIS_PACKET
NdisQueryBuffer
NdisQueryBufferSafe
NdisQueryPacket
ProtocolReceivePacket