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

mode_confirm() callback

Called to confirm the mode change completion

Synopsis:

#include <sys/pmm.h>

void mode_confirm(void *data, pm_power_mode_t mode, 
                      const pm_power_attr_t *attr);

Library:

libc

Description:

This function is called when a driver confirms that a mode change has been completed:

data

Policy specific data returned by the create() function when the node is created.

mode

Power that the driver has set the device to.

attr

Contains the current power mode status of the node:

attr->cur_mode is the original mode before this mode change has started
if attr->new_mode is the mode that the driver is requested to change to
If this is different to mode, it indicates that the driver can not honor the request.
attr->nxt_mode is different to new_mode, if another mode change is outstanding.
In this case, that mode change triggers on return from this function and the driver is instructed to change to this mode.

This call is intended to allow the policy to keep track of outstanding mode change requests, and to detect whether the mode change has been completed correctly.

There is no default action for this call.

Returns:

Classification:

QNX Neutrino