NdisAdjustBufferLength

9/8/2008

Essa função modifica o comprimento especificado em um descritor reserva alocado ou copiados pelo chamador.

Syntax

VOID NdisAdjustBufferLength(
  PNDIS_BUFFER Buffer,
  UINT Length
);

Parameters

• Buffer
  [no] Ponteiro para o descritor reserva previamente alocada com o NdisAllocateBuffer função.

• Comprimento
  [no] Especifica o novo tamanho, em bytes, ser definida no descritor de reserva.

Return Value

Nenhum.

Remarks

O chamador desta função pode transmitir apenas um descritor reserva que foi alocada pelo chamador. Ele não é possível transmitir um descritor reserva que foi alocada por outro driver.

De exemplo, o driver de um mestre barramento DMA NIC chama essa função com descritores reserva que ele alocada para especificar buffers de recepção no seu bloco memória compartilhada. Antes tal um driver indica dados recebidos, ela chama essa função para fazer a reserva descritor que ele inclui na indicação de recebimento coincidir com o tamanho dos dados recebidos se ela for menor do que o tamanho de buffer de recepção de NIC. Quando um pacote de recepção com tal um descritor ajustado reserva foi consumida e retornado para a miniporta, o driver novamente chama essa função para fazer o descritor reserva correspondem a real tamanho do seu buffer de recepção novamente.

O Comprimento parâmetro passado para essa função não pode ser maior do que o Comprimento que foi passado para o NdisAllocateBuffer função quando o descritor reserva foi alocada.

O chamador desta função deve restaurar o tamanho para sua original valor antes-libera o descritor reserva com o NdisFreeBuffer função.

O driver deve versão qualquer rotação bloqueio que ele está atualmente mantendo antes chamado essa função.

Requirements

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

See Also

Reference

NdisAllocateBuffer
NdisFreeBuffer
NdisReleaseSpinLock