HalAllocateCommonBuffer

9/8/2008

Essa função aloca memória, ele bloqueia e mapas-lo para que fique simultaneamente acessível de processador e um dispositivo para direcionar memória operações acessar (acesso direto à memória (DMA)).

Syntax

PVOID HalAllocateCommonBuffer(
  PDMA_ADAPTER_OBJECT DmaAdapter,
  ULONG Length,
  PPHYSICAL_ADDRESS LogicalAddress,
  BOOLEAN CacheEnabled
);

Parameters

• DmaAdapter
  [no] Ponteiro para estrutura descritor adaptador acesso direto à memória (DMA), DMA_ADAPTER_OBJECT.

• Comprimento
  [no] Tamanho da reserva para alocar.

• LogicalAddress
  [out] Ponteiro para o barramento-relativo, reserva endereço lógico usada pelo controlador acesso direto à memória (DMA) o barramento especificado.

• CacheEnabled
  [no] Ignorado. A reserva retornada é sempre em um endereço virtual uncached.

Return Value

Retorna um ponteiro para uma reserva alocada para o driver de dispositivo para usar. Retorna NULL se a função falhará.

Remarks

Essa função aloca uma reserva compartilhada de bloqueado, fisicamente contíguo páginas. Ele retorna o endereço virtual a ser usado por driver de dispositivo o acesso direto à memória (DMA) e o endereço lógico a ser usado pelo adaptador de acesso direto à memória (DMA) para acesso direto à memória (DMA) operações.

Requirements

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

See Also

Reference

DMA_ADAPTER_OBJECT
HalFreeCommonBuffer

Concepts

Direct Memory Access