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/impl/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   	SATA HBA's or specified SATA port current power level.
    			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 HBA's or specified SATA port
    power level. If addr field of the sata_device argument does not specify
    a valid SATA port, the request is for a HBA power level.
    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)