PowerXpress APIs
[Display Related APIs]


Functions

int ADL_Display_PowerXpressVersion_Get (int iAdapterIndex, int *lpVersion)
 Function to retrieve the PowerXpress version.
int ADL_Display_PowerXpressActiveGPU_Get (int iAdapterIndex, int *lpActiveGPU)
 Function to get the active GPU in PowerXpress.
int ADL_Display_PowerXpressActiveGPU_Set (int iAdapterIndex, int iActiveGPU, int *lpOperationResult)
 Function to set the active GPU in PowerXpress.
int ADL_Display_PowerXpress_AutoSwitchConfig_Get (int iAdapterIndex, int *lpAutoSwitchOnACDCEvent, int *lpAutoSwitchOnDCACEvent)
 Function to retrieve the auto switch configuration setting for PowerXpress. This is not supported when DPPE state switching is configured.
int ADL_Display_PowerXpress_AutoSwitchConfig_Set (int iAdapterIndex, int iAutoSwitchOnACDCEvent, int iAutoSwitchOnDCACEvent)
 Function to set the auto switch configuration setting for PowerXpress. This is not supported when DPPE state switching is configured.
int ADL_PowerXpress_Config_Caps (int iAdapterIndex, ADLPXConfigCaps *lpPXConfigCaps)
 This function gets the PowerXpress configuration Caps.
int ADL_PowerXpress_Scheme_Get (int iAdapterIndex, ADLPXScheme *lpPXSchemeRange, ADLPXScheme *lpPXSchemeCurrentState, ADLPXScheme *lpPXSchemeDefaultState)
 This function gets the PowerXpress scheme.
int ADL_PowerXpress_Scheme_Set (int iAdapterIndex, ADLPXScheme scheme)
 This function sets the PowerXpress scheme.
int ADL_PowerXpress_AncillaryDevices_Get (int iAdapterIndex, int *lpNumberOfAncillaryDevices, ADLBdf **lppAncillaryDevices)
 This function gets ancillary GPUs.

Detailed Description

This group outlines PowerXpress Related APIs.

Function Documentation

int ADL_Display_PowerXpressVersion_Get ( int  iAdapterIndex,
int *  lpVersion 
)

Function to retrieve the PowerXpress version.

This function retrieves the PowerXpress version.

Supported Platforms:
Linux and Windows(XP, Vista and Windows 7); 32bit and 64bit
Parameters:
[in] iAdapterIndex The ADL index handle of the desired adapter.
[out] lpVersion The pointer to the value storing the retrieved version.
Returns:
If the system is PowerXpress capable, the function returns ADL_OK and lpVersion is always set to ADL_DL_POWERXPRESS_VERSION

If the system is not PowerXpress capable, the function returns a value different from ADL_OK

int ADL_Display_PowerXpressActiveGPU_Get ( int  iAdapterIndex,
int *  lpActiveGPU 
)

Function to get the active GPU in PowerXpress.

This function retrieves the active GPU in PowerXpress.

Supported Platforms:
Linux and Windows(XP, Vista and Windows 7); 32bit and 64bit
Parameters:
[in] iAdapterIndex The ADL index handle of the desired adapter.
[out] lpActiveGPU The pointer to the value storing the active GPU in PowerXpress: ADL_DL_POWERXPRESS_GPU_INTEGRATED or ADL_DL_POWERXPRESS_GPU_DISCRETE
Returns:
If the function succeeds, the return value is ADL_OK. Otherwise the return value is an ADL error code. Result Codes

int ADL_Display_PowerXpressActiveGPU_Set ( int  iAdapterIndex,
int  iActiveGPU,
int *  lpOperationResult 
)

Function to set the active GPU in PowerXpress.

This function sets the active GPU in PowerXpress.

Supported Platforms:
Linux and Windows(XP, Vista and Windows 7); 32bit and 64bit
Parameters:
[in] iAdapterIndex The ADL index handle of the desired adapter.
[in] iActiveGPU The value of the desired active GPU in PowerXpress: ADL_DL_POWERXPRESS_GPU_INTEGRATED or ADL_DL_POWERXPRESS_GPU_DISCRETE
[out] lpOperationResult The pointer to the retrieved result of the operation.
Returns:
If the function succeeds, the return value is ADL_OK. Otherwise the return value is an ADL error code. Result Codes

int ADL_Display_PowerXpress_AutoSwitchConfig_Get ( int  iAdapterIndex,
int *  lpAutoSwitchOnACDCEvent,
int *  lpAutoSwitchOnDCACEvent 
)

Function to retrieve the auto switch configuration setting for PowerXpress. This is not supported when DPPE state switching is configured.

This function retrieves the auto switch configuration setting for PowerXpress. This is not supported when DPPE state switching is configured.

Supported Platforms:
Linux and Windows(XP, Vista and Windows 7); 32bit and 64bit
Parameters:
[in] iAdapterIndex The ADL index handle of the desired adapter.
[out] lpAutoSwitchOnACDCEvent The pointer to the switch configuration for ACDC. The returned value could be 0 or 1
[out] lpAutoSwitchOnDCACEvent The pointer to the switch configuration for DCAC. The returned value could be 0 or 1
Returns:
If the function succeeds, the return value is ADL_OK. Otherwise the return value is an ADL error code. Result Codes

int ADL_Display_PowerXpress_AutoSwitchConfig_Set ( int  iAdapterIndex,
int  iAutoSwitchOnACDCEvent,
int  iAutoSwitchOnDCACEvent 
)

Function to set the auto switch configuration setting for PowerXpress. This is not supported when DPPE state switching is configured.

This function sets the auto switch configuration setting for PowerXpress. This is not supported when DPPE state switching is configured.

Supported Platforms:
Linux and Windows(XP, Vista and Windows 7); 32bit and 64bit
Parameters:
[in] iAdapterIndex The ADL index handle of the desired adapter.
[in] iAutoSwitchOnACDCEvent The pointer to the value used to set the switch configuration for ACDC. Set value 0 or 1
[in] iAutoSwitchOnDCACEvent The pointer to the value used to set the switch configuration for DCAC. Set value 0 or 1
Returns:
If the function succeeds, the return value is ADL_OK. Otherwise the return value is an ADL error code. Result Codes

int ADL_PowerXpress_Config_Caps ( int  iAdapterIndex,
ADLPXConfigCaps lpPXConfigCaps 
)

This function gets the PowerXpress configuration Caps.

This function gets the PowerXpress configuration Caps.

Supported Platforms:
Windows 7; 32bit and 64bit
Parameters:
[in] iAdapterIndex The ADL index handle of the desired adapter.
[out] lpPXConfigCaps The pointer to the PowerXpress config Caps returned: ADLPXConfigCaps
Returns:
If the function succeeds, the return value is ADL_OK. Otherwise the return value is an ADL error code. Result Codes

int ADL_PowerXpress_Scheme_Get ( int  iAdapterIndex,
ADLPXScheme lpPXSchemeRange,
ADLPXScheme lpPXSchemeCurrentState,
ADLPXScheme lpPXSchemeDefaultState 
)

This function gets the PowerXpress scheme.

This function gets the PowerXpress scheme.

Supported Platforms:
Windows 7; 32bit and 64bit
Parameters:
[in] iAdapterIndex The ADL index handle of the desired adapter.
[out] lpPXSchemeRange The pointer to the scheme range to be returned: ADLPXScheme
[out] lpPXSchemeCurrentState The pointer to the current scheme to be returned: ADLPXScheme
[out] lpPXSchemeDefaultState The pointer to the default scheme to be returned: ADLPXScheme
Returns:
If the function succeeds, the return value is ADL_OK. Otherwise the return value is an ADL error code. Result Codes

int ADL_PowerXpress_Scheme_Set ( int  iAdapterIndex,
ADLPXScheme  scheme 
)

This function sets the PowerXpress scheme.

This function sets the PowerXpress scheme.

Supported Platforms:
Windows 7; 32bit and 64bit
Parameters:
[in] iAdapterIndex The ADL index handle of the desired adapter.
[in] scheme The PX scheme to set: ADLPXScheme
Returns:
If the function succeeds, the return value is ADL_OK. Otherwise the return value is an ADL error code. Result Codes

int ADL_PowerXpress_AncillaryDevices_Get ( int  iAdapterIndex,
int *  lpNumberOfAncillaryDevices,
ADLBdf **  lppAncillaryDevices 
)

This function gets ancillary GPUs.

In Power Express configuration system, the master GPU(Integrated GPU) can have several linked GPU which can be removed by the driver. These removable GPU are called ancillary devices. They are usually discrete GPUs in Power Express system

Supported Platforms:
Windows 7; 32bit and 64bit
Parameters:
[in] iAdapterIndex The ADL index handle of the desired adapter.
[out] lpNumberOfAncillaryDevices Pointer to a variable that indicates the number of ancillary devices.
[out] lppRemovableDevices Pointer of a pointer to a variable with type ADLBdf, which contains a list of ancillary devices .
Returns:
If the function succeeds, the return value is ADL_OK. Otherwise the return value is an ADL error code. Result Codes


Copyright © 2009-2013 Advanced Micro Devices, Inc. All rights reserved.  AMD Developer