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

pmm_state_change()

Perform a state transition to a new state

Synopsis:

#include <sys/pmm.h>

int pmm_state_change(void *hdl, unsigned new_state);

Library:

libc

Description:

This function is used to perform a state transtion to a new state.

hdl

Handle to the state machine, returned by pmm_state_init().

new_state

State to be entered.

If this is the same as the current state, this call returns without invoking any of the state functions.

This function ensures that only one thread at a time performs a state transition:

• this is serialised with any transition being performed via pmm_state_machine()
• this blocks any pmm_state_check() function until the transition is completed.

If successful, this call returns EOK.

If an error occurs, it returns -1 and errno is set one of the following:

Returns:

Classification:

QNX Neutrino

See also: