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

ado_rwlock_destroy()

Destroy a read-write lock

Synopsis:

#include <audio_driver.h>

ado_rwlock_destroy( pthread_rwlock_t *rwl )

Arguments:

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

Description:

The ado_rwlock_destroy() macro destroys the given read-write lock.

This macro is defined as pthread_rwlock_destroy(), or ado_rwlock_destroy_debug() if ADO_RWLOCK_DEBUG and ADO_DEBUG are defined. The debug version uses ado_debug() to display a message to help you locate 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_destroy():

EOK
Success.
EBUSY
The read-write lock is still in use. The behavior of this read-write lock is now undefined.

Classification:

QNX Neutrino

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

See also:

ado_rwlock_init(), ado_rwlock_rdlock(), ado_rwlock_unlock(), ado_rwlock_wrlock()

pthread_rwlock_destroy() in the QNX Library Reference