ado_shm_alloc()

Allocate shared memory

Synopsis:

#include <audio_driver.h>

void *ado_shm_alloc( size_t size,
                     char *name,
                     int32_t flags,
                     off64_t *phys_addr );

Arguments:

size
The size of the block to allocate, in bytes.
name
The name of the shared region. The storage requirements for name are defined as QNX_SHM_NAME_LEN.
flags
Restrictions on the memory region; any combination of:
phys_addr
A pointer to where ado_shm_alloc() should store the physical address of the region.

Description:

The ado_shm_alloc() function allocates a block of shared memory. You use it mostly for the DMA buffer so that it can be shared.

The ado_shm_mmap() function is for cards where the DMA buffer is in onboard memory; it mmaps the card memory and makes the region shared without allocating it.

Returns:

A pointer to the allocated memory, or NULL if an error occurred (errno is set).

Classification:

QNX Neutrino

Safety:
Cancellation point No
Interrupt handler No
Signal handler No
Thread Yes

See also:

ado_shm_free(), ado_shm_mmap()