NdisQueryPacket

9/8/2008

Essa função retorna informações sobre um pacote especificado.

Syntax

VOID NdisQueryPacket(
  PNDIS_PACKET Packet,
  PUINT PhysicalBufferCount,
  PUINT BufferCount,
  PNDIS_BUFFER* FirstBuffer,
  PUINT TotalPacketLength
);

Parameters

• Pacote
  [no] Ponteiro para um descritor pacote.

• PhysicalBufferCount
  [out] Opcional. Ponteiro para uma variável Caller-supplied que contém o número máximo de físico quebras mapeadas pelo descritores de reserva. Este parâmetro pode ser NULL.

• BufferCount
  [out] Opcional. Ponteiro para uma variável Caller-supplied no qual essa função retorna o número de descritores reserva encadeadas para o pacote especificado. Este parâmetro pode ser NULL.

• FirstBuffer
  [out] Opcional. Ponteiro para uma variável Caller-supplied no qual essa função retorna um ponteiro para o descritor reserva inicial encadeada para o pacote especificado. Este parâmetro pode ser NULL.

• TotalPacketLength
  [out] Opcional. Ponteiro para uma variável Caller-supplied no qual essa função retorna o número de bytes de dados pacote mapeados por todos os descritores encadeado reserva. Este parâmetro pode ser NULL.

Return Value

Retorna o número máximo de físico quebras mapeadas pelo descritores de reserva encadeados para o pacote especificado.

Remarks

Essa função retorna informações Caller-Selected sobre um pacote especificado. O chamador deve especificar um at least da PhysicalBufferCount, BufferCount, FirstBuffer, e TotalPacketLength Ponteiros, juntamente com o Packet parâmetro. Um chamador pode especificar ponteiros explícita para todos os parâmetros.

Um driver pode chamar o NdisGetNextBuffer função, como many times conforme necessário para recuperar os ponteiros para quaisquer descritores reserva subseqüentes no encadear, a menos que o chamar retorna 0, indicando que o descritor pacote tem não dados.

Se o chamador fornece um explícita BufferCount ponteiro, essa função retorna o número de descritores reserva encadear o pacote. O valor de retorno pode ser usado como um executar um loop contador para recuperar descritores reserva no encadear com um do NdisUnchainBufferXXX funções.

Se o chamador fornece um explícita FirstBuffer ponteiro mas encadear reserva do pacote está vazio, essa função retorna NULL em FirstBuffer. Caso contrário, o chamador pode usar NdisQueryBuffer subseqüentemente para get detalhes sobre o descritor reserva inicial para o pacote. Como um alternativo mais rápido, drivers podem chamar NdisGetFirstBufferFromPacket Para um ponteiro para o descritor reserva inicial get.

Se o chamador fornece um explícita TotalPacketLength ponteiro, essa função retorna o número total de bytes especificado por cada descritor reserva encadeada para o pacote especificado.

Requirements

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

See Also

Reference

NdisGetFirstBufferFromPacket
NdisGetNextBuffer
NdisQueryBuffer
NdisUnchainBufferAtBack
NdisUnchainBufferAtFront