NdisCopyBuffer

9/8/2008

Essa função cria um descritor reserva para um subintervalo virtual especificado, fornecido um identificador para um bloco de memória já alocada e um ponteiro para o descritor memória para o bloco.

Syntax

VOID NdisCopyBuffer(
  PNDIS_STATUS Status,
  PNDIS_BUFFER* Buffer,
  NDIS_HANDLE PoolHandle,
  PVOID MemoryDescriptor,
  UINT Offset,
  UINT Length
);

Parameters

• Status
  [out] Aponta para uma variável Caller-supplied no qual essa função retorna o status final da operação copiar descritor de reserva.

• Buffer
  [out] Aponta para uma variável Caller-supplied em que essa função retorna um ponteiro para o novo descritor reserva se o chamar é bem-sucedido.

• PoolHandle
  [no] Especifica o identificador retornado por uma acima chamar para NdisAllocateBufferPool.

• MemoryDescriptor
  [no] Aponta para o descritor memória, que pode ser do tipo NDIS_BUFFER.

• Deslocamento
  [no] Especifica o deslocamento de byte no bloco de memória no qual se iniciar a copiar.

• Comprimento
  [no] Especifica o número de bytes para copiar.

Return Value

A seguinte tabela mostra os valores de retorno para esta função.

Valor	Descrição
NDIS_STATUS_SUCCESS	O driver pode usar o descritor reserva ou reserva descritor encadear retornado no Buffer.
NDIS_STATUS_FAILURE	Uma tentativa mapa (n.); mapear (v.) o intervalo determinado falha, possivelmente because of um out - of - intervalo Deslocamento e Comprimento Especificação.

Remarks

NdisCopyBuffer Cria um mapeamento descritor reserva um intervalo dentro uma bloco de memória, descrito por um descritor memória determinado. Essa função aloca armazenamento para o novo descritor reserva e, em seguida, copia informações a partir de determinado MemoryDescriptor para o novo descritor reserva.

Se o descritor memória determinado contém elementos encadeados, o descritor reserva que NdisCopyBuffer Cria pode ser o início de um encadear de reserva descritores. Um driver pode chamar NdisGetNextBuffer e, em seguida, NdisQueryBufferSafe a consulta cada encadeada reserva descritor.

O driver deve versão qualquer rotação bloqueio ele está mantendo antes chamado NdisCopyBuffer. O driver deve chamar NdisFreeBuffer a versão o descritor reserva quando ele é necessário no longer.

Requirements

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

See Also

Reference

NdisAllocateBufferPool
NdisFreeBuffer
NdisGetNextBuffer
NdisQueryBuffer
NdisQueryBufferSafe
NdisReleaseSpinLock