Driver Entry Points				sata_tran_get_pwr_level(9E)

NAME
    sata_tran_get_pwr_level - return SATA HBA's current power level
    
SYNOPSIS
    #include <sys/sata/sata_hba.h>

    int sata_tran_get_pwr_level(dev_info_t  *dev_info,
    				sata_device_t *sata_device);


INTERFACE LEVEL
    Consolidation Private

PARAMETERS
    dev_info		Pointer to a dev_info_t structure, referring to the HBA
    			device instance.
    sata_device   	device for which the power level is requested.
    			If addr field does not specify valid SATA port, the
    			power level of the HBA should be returned.

DESCRIPTION
    The sata_tran_get_pwr_level() function returns the power level of HBA or
    specified SATA port. If addr field of the sata_device argument does not 
    specify a valid SATA port, the request is for power level of the HBA itself. 
    A power level numerical value should be returned in the num_info field
    of the sata_device argument.
    This function may be called in response to the SATA HBA event
    notification indicating SATA HBA power level change.


RETURN VALUE
    sata_tran_get_pwr_level() must return:
    	
    SATA_SUCCESS 	The level value represents current SATA HBA power level.
    			
    SATA_FAILURE 	The current power level of the HBA or specified
    			SATA device port cannot be determined.
    			The level value is not valid.

SEE ALSO
    sata_hba_tran(9S), sata_tran_pwrmgt_ops(9S)