LPOALFreeCommonBuffer (Windows Embedded CE 6.0)

1/6/2010

This function frees a common buffer allocated by LPOALAllocateCommonBuffer, along with all resources the buffer uses. A similar function is HalFreeCommonBuffer.

Syntax

typedef BOOL (* LPOALFreeCommoneBuffer)(
    PDMA_PDD_ADAPTER_CONTEXT lpPddAdapterContext,
    PCE_DMA_ADAPTER DmaAdapter,
  ULONG Length,
  PHYSICAL_ADDRESS LogicalAddress,
  PVOID VirtualAddress,
  BOOLEAN CacheEnabled
);

Parameters

• lpPddAdapterContext
  [in] Pointer to a DMA_PDD_ADAPTER_CONTEXT structure.

• DmaAdapter
  [in] Pointer to a CE_DMA_ADAPTER structure.

• Length
  [in] Size of buffer to allocate.

• LogicalAddress
  [in] Pointer to the bus-relative, logical address buffer used by the DMA controller on the specified bus.

• VirtualAddress
  [in] Pointer to virtual address buffer.

• CacheEnabled
  [in] Ignored. The buffer returned is always at an uncached virtual address.

Return Value

Returns TRUE on success. Returns FALSE if an error occurs.

Requirements

See Also

Reference

Direct Memory Access Abstraction PDD Functions