ado_rwlock_wrlock()

Acquire an exclusive write lock on a read-write lock

Synopsis:

#include <audio_driver.h>

int ado_rwlock_wrlock( pthread_rwlock_t *rwl );

Arguments:

rwl

A pointer to the pthread_rwlock_t structure for the read-write lock.

Description:

This macro acquires an exclusive write lock on the given read-write lock.

The ado_rwlock_wrlock() macro is defined as pthread_rwlock_wrlock(), or ado_rwlock_wrlock_debug(), if ADO_RWLOCK_DEBUG and ADO_DEBUG are defined. The debug version uses ado_debug() to display a message, to aid in locating a locking problem in the driver.

For more information, see "Debugging an audio driver" in the Organization of a Driver chapter.

Returns:

Same as pthread_rwlock_wrlock():

EOK

Success.

EAGAIN

On the first use of a statically initialized read-write lock, insufficient system resources existed to initialize the read-write lock.

EDEADLK

The calling thread already has an exclusive lock for rwl.

EFAULT

A fault occurred when the kernel tried to access rwl.

EINVAL

The read-write lock rwl is invalid.

Classification:

QNX Neutrino

See also:

ado_rwlock_destroy(), ado_rwlock_init(), ado_rwlock_rdlock(), ado_rwlock_unlock()

pthread_rwlock_wrlock() in the QNX Library Reference