DMAOpenBuffer

9/8/2008

Essa função é usada para mapa (n.); mapear (v.) uma reserva virtual para um físico bloco acesso direto à memória (DMA).

Syntax

DMA_BUFFER_HANDLE DMAOpenBuffer (
  PCE_DMA_ADAPTER pDmaAdapter,
  DWORD dwNumBuffer,
  PVOID pBufferArray[],
  DWORD aLength[],
);

Parameters

• pDmaAdapter
  [no] Ponteiro para uma estrutura CE_DMA_ADAPTER , que seja retornado pela função DMAGetAdapter ou é criado pelo chamador para Bus Mastering DMA.

• DwNumBuffer
  [no] Número de buffers virtuais passado para DMAOpenBuffer.

• [pBufferArray]
  [no] Ponteiro para uma matriz de endereços virtuais. Esta matriz é limitada pelo valor do parâmetro dwNumBuffer.

• [aLength]
  [no] Ponteiro para uma matriz de comprimento. Esta matriz é limitada pelo valor dwNumber.

Return Value

Retorna um diferente de zero valor em caso de sucesso. Retorna zero em falha. Para informações de erro estendidas, o driver usuário pode chamar GetLastError.

Remarks

O DMA_BUFFER_HANDLE retornado por essa função pode ser usado com outras funções reserva acesso direto à memória (DMA). DMAOpenBuffer irá alocar estruturas internas e criar um descritor bloco reserva acesso direto à memória (DMA). Se necessário, ele será também chamar HalAllocateCommonBuffer.

Requirements

Header	oaldma.h
Library	CEDDK.lib
Windows Embedded CE	Windows Embedded CE 6.0 and later

See Also

Reference

CEDDK Dynamic-Link Library DMA Functions
CEDDK Dynamic-Link Library DMA Structures