Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

ado_shm_mmap()

Map a shared memory region into the Audio HW DLL's address space

Synopsis:

#include <audio_driver.h>

void *ado_shm_mmap( off64_t phys_addr,
                    size_t size,
                    char *name );

Arguments:

phys_addr
The physical address of the region.
size
The size of the region.
name
The name of the region. The storage requirements for name are defined as QNX_SHM_NAME_LEN.

Description:

The ado_shm_mmap() function maps a shared memory region into the Audio HW DLL's address space. This 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.

The ado_shm_alloc() function allocates a shared memory region; you use it mostly for the DMA buffer so that it can be shared.

Returns:

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

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

ado_shm_alloc(), ado_shm_free()