pm_get_normal_power(9F)

NAME

pm_get_normal_power, pm_set_normal_power − get or set a device component’s normal power level

SYNOPSIS

#include <sys/ddi.h>
#include <sys/sunddi.h>

int pm_get_normal_power(dev_info_t ∗dip, int component);

void pm_set_normal_power(dev_info_t ∗dip, int component, int level);

INTERFACE LEVEL

Solaris DDI specific (Solaris DDI).

ARGUMENTS

pm_get_normal_power()

dip Pointer to the device’s dev_info structure.

component Number of component to get normal power level of.

pm_set_normal_power()

dip Pointer to the device’s dev_info structure.

component Number of component to set normal power level for.

level Power level to become the component’s new normal power level.

DESCRIPTION

The pm_get_normal_power() function returns the normal power level of component of the device dip.

The pm_set_normal_power() function sets the normal power level of component of the device dip to level.

When a device has been power-managed by pm(7D) and is being returned to a state to be used by the system, it will be brought to its normal power level. Except for a power level of 0, which is defined by the system to mean “powered off”, or a power level in the range 1-15, which are reserved, the interpretation of the meaning of the power level is entirely up to the driver.

RETURN VALUES

The pm_get_normal_power() function returns:

level The normal power level of the specified component (a postive integer).

DDI_FAILURE
Invalid component number component or the device has no components.

CONTEXT

These functions can be called from user or kernel context.

Museum

Related Articles