ADL (AMD Display Library) Public APIs
Version 17.1
|
This group describes the Display Manager APIs. More...
Functions | |
int | ADL2_Adapter_AMDAndNonAMDDIsplayClone_Get (ADL_CONTEXT_HANDLE context, int iAdapterIndex, int *lpHasAMDAndNonAMDDIsplays) |
ADL local interface. Retrieves GPU information of any AMD and non-AMD displays cloned for given GPU or all OS-known GPUs. More... | |
int | ADL2_Adapter_CloneTypes_Get (ADL_CONTEXT_HANDLE context, int iAdapterIndex, int *lpCloneTypes) |
ADL local interface. Retrieves GPU information of special clone types for given GPU or all OS-known GPUs. More... | |
int | ADL2_Adapter_CrossGPUClone_Disable (ADL_CONTEXT_HANDLE context, int iAdapterIndex, int iOptions) |
ADL local interface. Disable all cross-GPU clone for given GPU or all OS-known GPUs. More... | |
int | ADL2_Adapter_Display_Caps (ADL_CONTEXT_HANDLE context, int iAdapterIndex, int *lpNumDisplayCaps, ADLAdapterDisplayCap **lppAdapterDisplayCaps) |
Function to retrieve the adapter display manner capabilities based on ADL index. More... | |
int | ADL2_Adapter_NumberOfActivatableSources_Get (ADL_CONTEXT_HANDLE context, int iAdapterIndex, int *lpNumSources, ADLActivatableSource **lppSources) |
Function to retrieve the number of Activatable sources based on ADL Index. More... | |
int | ADL2_Display_DisplayMapConfig_Get (ADL_CONTEXT_HANDLE context, int iAdapterIndex, int *lpNumDisplayMap, ADLDisplayMap **lppDisplayMap, int *lpNumDisplayTarget, ADLDisplayTarget **lppDisplayTarget, int iOptions) |
Function to retrieve current display map configurations. More... | |
int | ADL2_Display_DisplayMapConfig_PossibleAddAndRemove (ADL_CONTEXT_HANDLE context, int iAdapterIndex, int iNumDisplayMap, ADLDisplayMap *lpDisplayMap, int iNumDisplayTarget, ADLDisplayTarget *lpDisplayTarget, int *lpNumPossibleAddTarget, ADLDisplayTarget **lppPossibleAddTarget, int *lpNumPossibleRemoveTarget, ADLDisplayTarget **lppPossibleRemoveTarget) |
Function to validate a list of display configurations. More... | |
int | ADL2_Display_DisplayMapConfig_Set (ADL_CONTEXT_HANDLE context, int iAdapterIndex, int iNumDisplayMap, ADLDisplayMap *lpDisplayMap, int iNumDisplayTarget, ADLDisplayTarget *lpDisplayTarget) |
Function to set the current display configuration. More... | |
int | ADL2_Display_DisplayMapConfig_Validate (ADL_CONTEXT_HANDLE context, int iAdapterIndex, int iNumPossibleMap, ADLPossibleMap *lpPossibleMaps, int *lpNumPossibleMapResult, ADLPossibleMapResult **lppPossibleMapResult) |
Function to validate the list of the display configurations based on ADL Index. More... | |
int | ADL2_Display_ForcibleDisplay_Get (ADL_CONTEXT_HANDLE context, int iAdapterIndex, int iDisplayIndex, int *lpStatus) |
Function to retrieve the forcible connected status of a display. More... | |
int | ADL2_Display_ForcibleDisplay_Set (ADL_CONTEXT_HANDLE context, int iAdapterIndex, int iDisplayIndex, int iStatus) |
Function to set the forcible connected status of a display. More... | |
int | ADL2_Display_Modes_Get (ADL_CONTEXT_HANDLE context, int iAdapterIndex, int iDisplayIndex, int *lpNumModes, ADLMode **lppModes) |
Function to retrieve the display mode information. More... | |
int | ADL2_Display_Modes_Set (ADL_CONTEXT_HANDLE context, int iAdapterIndex, int iDisplayIndex, int iNumModes, ADLMode *lpModes) |
Function to set display mode information. More... | |
int | ADL2_Display_PossibleMapping_Get (ADL_CONTEXT_HANDLE context, int iAdapterIndex, int iNumberOfPresetMapping, ADLPossibleMapping *lpPresetMappings, int iEnquiryControllerIndex, int *lpNumberOfEnquiryPossibleMappings, ADLPossibleMapping **lppEnquiryPossibleMappings) |
Function to retrieve the possible display mappings. More... | |
int | ADL2_Display_PossibleMode_Get (ADL_CONTEXT_HANDLE context, int iAdapterIndex, int *lpNumModes, ADLMode **lppModes) |
Function to retrieve the OS possible modes list for an adapter (all OS platforms). More... | |
int | ADL2_Workstation_EnableUnsupportedDisplayModes (ADL_CONTEXT_HANDLE context, int iAdapterIndex) |
Function to set the Registry key "UnsupportedMonitorModesAllowed" when 10bit Pixel format is enabled from workstation aspect. More... | |
int | ADL_Adapter_Display_Caps (int iAdapterIndex, int *lpNumDisplayCaps, ADLAdapterDisplayCap **lppAdapterDisplayCaps) |
Function to retrieve the adapter display manner capabilities based on ADL index. More... | |
int | ADL_Adapter_NumberOfActivatableSources_Get (int iAdapterIndex, int *lpNumSources, ADLActivatableSource **lppSources) |
Function to retrieve the number of Activatable sources based on ADL Index. More... | |
int | ADL_Display_DisplayMapConfig_Get (int iAdapterIndex, int *lpNumDisplayMap, ADLDisplayMap **lppDisplayMap, int *lpNumDisplayTarget, ADLDisplayTarget **lppDisplayTarget, int iOptions) |
Function to retrieve current display map configurations. More... | |
int | ADL_Display_DisplayMapConfig_PossibleAddAndRemove (int iAdapterIndex, int iNumDisplayMap, ADLDisplayMap *lpDisplayMap, int iNumDisplayTarget, ADLDisplayTarget *lpDisplayTarget, int *lpNumPossibleAddTarget, ADLDisplayTarget **lppPossibleAddTarget, int *lpNumPossibleRemoveTarget, ADLDisplayTarget **lppPossibleRemoveTarget) |
Function to validate a list of display configurations. More... | |
int | ADL_Display_DisplayMapConfig_Set (int iAdapterIndex, int iNumDisplayMap, ADLDisplayMap *lpDisplayMap, int iNumDisplayTarget, ADLDisplayTarget *lpDisplayTarget) |
Function to set the current display configuration. More... | |
int | ADL_Display_DisplayMapConfig_Validate (int iAdapterIndex, int iNumPossibleMap, ADLPossibleMap *lpPossibleMaps, int *lpNumPossibleMapResult, ADLPossibleMapResult **lppPossibleMapResult) |
Function to validate the list of the display configurations based on ADL Index. More... | |
int | ADL_Display_ForcibleDisplay_Get (int iAdapterIndex, int iDisplayIndex, int *lpStatus) |
Function to retrieve the forcible connected status of a display. More... | |
int | ADL_Display_ForcibleDisplay_Set (int iAdapterIndex, int iDisplayIndex, int iStatus) |
Function to set the forcible connected status of a display. More... | |
int | ADL_Display_Modes_Get (int iAdapterIndex, int iDisplayIndex, int *lpNumModes, ADLMode **lppModes) |
Function to retrieve the display mode information. More... | |
int | ADL_Display_Modes_Set (int iAdapterIndex, int iDisplayIndex, int iNumModes, ADLMode *lpModes) |
Function to set display mode information. More... | |
int | ADL_Display_PossibleMapping_Get (int iAdapterIndex, int iNumberOfPresetMapping, ADLPossibleMapping *lpPresetMappings, int iEnquiryControllerIndex, int *lpNumberOfEnquiryPossibleMappings, ADLPossibleMapping **lppEnquiryPossibleMappings) |
Function to retrieve the possible display mappings. More... | |
int | ADL_Display_PossibleMode_Get (int iAdapterIndex, int *lpNumModes, ADLMode **lppModes) |
Function to retrieve the OS possible modes list for an adapter (all OS platforms). More... | |
int | ADL_Workstation_EnableUnsupportedDisplayModes (int iAdapterIndex) |
Function to set the Registry key "UnsupportedMonitorModesAllowed" when 10bit Pixel format is enabled from workstation aspect. More... | |
This group describes the Display Manager APIs.
int ADL2_Adapter_AMDAndNonAMDDIsplayClone_Get | ( | ADL_CONTEXT_HANDLE | context, |
int | iAdapterIndex, | ||
int * | lpHasAMDAndNonAMDDIsplays | ||
) |
ADL local interface. Retrieves GPU information of any AMD and non-AMD displays cloned for given GPU or all OS-known GPUs.
This function retrieves information for passed adapter or -1 for all GPUs.
[in] | context | Client's ADL context handle ADL_CONTEXT_HANDLE obtained from ADL2_Main_Control_Create. |
[in] | iAdapterIndex | The ADL index handle of the desired adapter(one of GPU adapter index) or -1 if all GPUs are desired. For A+I system, please pass -1 only. |
[out] | lpHasAMDAndNonAMDDIsplays | pointer to an integer. It is 1 if there is any AMd and non-AMD displays cloned in the GPU or the system |
int ADL2_Adapter_CloneTypes_Get | ( | ADL_CONTEXT_HANDLE | context, |
int | iAdapterIndex, | ||
int * | lpCloneTypes | ||
) |
ADL local interface. Retrieves GPU information of special clone types for given GPU or all OS-known GPUs.
This function retrieves special clone types information for passed adapter or -1 for all GPUs. Currently, cross-GPU-clone and corss-GPU-clone-AMDWithNonAMD
[in] | context | Client's ADL context handle ADL_CONTEXT_HANDLE obtained from ADL2_Main_Control_Create. |
[in] | iAdapterIndex | The ADL index handle of the desired adapter(one of GPU adapter index) or -1 if all GPUs are desired. For A+I system, please pass -1 only. |
[out] | lpCloneTypes | pointer to an integer. It is bit vector. If the first bit is 1, the clone is cross-GPU-clone. It is may AMD with AMD or AMD with non-AMD. If The second bit is 1, the clone is cross-GPU-clone, but with non-AMD displays. It is available in WIN10 and WIN 8.1 PX A+I system |
int ADL2_Adapter_CrossGPUClone_Disable | ( | ADL_CONTEXT_HANDLE | context, |
int | iAdapterIndex, | ||
int | iOptions | ||
) |
ADL local interface. Disable all cross-GPU clone for given GPU or all OS-known GPUs.
This function disables the cross-GPU clone for passed adapter(GPU) or -1 for all GPUs.
[in] | context | Client's ADL context handle ADL_CONTEXT_HANDLE obtained from ADL2_Main_Control_Create. |
[in] | iAdapterIndex | The ADL index handle of the desired adapter(one of GPU adapter index) or -1 if all GPUs are desired. For A+I system, please pass -1 only. |
[in] | iOptions | is an integer, which decides the displays from other GPUs will be disabled or changed to extended mode. Currently, the API only supports the "disabled". This filed is just for extension for future useage. |
int ADL2_Adapter_Display_Caps | ( | ADL_CONTEXT_HANDLE | context, |
int | iAdapterIndex, | ||
int * | lpNumDisplayCaps, | ||
ADLAdapterDisplayCap ** | lppAdapterDisplayCaps | ||
) |
Function to retrieve the adapter display manner capabilities based on ADL index.
This function retrieves the adapter display manner capabilities (e.g., single, clone, extended desktop, and stretch mode).
[in] | context | Client's ADL context handle ADL_CONTEXT_HANDLE obtained from ADL2_Main_Control_Create. |
[in] | iAdapterIndex | The ADL index handle of the desired adapter. A value of -1 returns all adapter manner information for the system across all GPUs. |
[out] | lpNumDisplayCaps | The Number of display manner capabilities. |
[out] | lppAdapterDisplayCaps | The lists of display manner capabilities across all GPUs. Refer to the ADLAdapterDisplayCap structure for more information. |
int ADL2_Adapter_NumberOfActivatableSources_Get | ( | ADL_CONTEXT_HANDLE | context, |
int | iAdapterIndex, | ||
int * | lpNumSources, | ||
ADLActivatableSource ** | lppSources | ||
) |
Function to retrieve the number of Activatable sources based on ADL Index.
This function retrieves the activatable sources list for a specified input adapter. ActivatableSources is the number of displays that can be turned on simultaneously for the same GPU. For example, for AMD Radeon HD 4xxx Series and earlier this number is 2 while for ATI Radeon HD 5xxx Series the number could be 6 or 4.
[in] | context | Client's ADL context handle ADL_CONTEXT_HANDLE obtained from ADL2_Main_Control_Create. |
[in] | iAdapterIndex | The ADL index handle of the desired adapter. |
[out] | lpNumSources | The pointer to the number of sources that can be activated. |
[out] | lppSources | The pointer to the pointer to the retrieved activatable sources buffer. Refer to the ADLActivatableSource structure for more information. |
int ADL2_Display_DisplayMapConfig_Get | ( | ADL_CONTEXT_HANDLE | context, |
int | iAdapterIndex, | ||
int * | lpNumDisplayMap, | ||
ADLDisplayMap ** | lppDisplayMap, | ||
int * | lpNumDisplayTarget, | ||
ADLDisplayTarget ** | lppDisplayTarget, | ||
int | iOptions | ||
) |
Function to retrieve current display map configurations.
This function retrieves the current display map configurations, including the controllers and adapters mapped to each display.
[in] | context | Client's ADL context handle ADL_CONTEXT_HANDLE obtained from ADL2_Main_Control_Create. |
[in] | iAdapterIndex | The ADL index handle of the desired adapter. A value of -1 returns all display configurations for the system across multiple GPUs. |
[out] | lpNumDisplayMap | The pointer to the number of retrieved display maps. |
[out] | lppDisplayMap | The pointer to the pointer to the display manner information. Refer to the ADLDisplayMap structure for more information. |
[out] | lpNumDisplayTarget | The pointer to the display target sets retrieved. |
[out] | lppDisplayTarget | The pointer to the pointer to the display target buffer. Refer to the ADLDisplayTarget structure for more information. |
[in] | iOptions | The function option. ADL_DISPLAY_DISPLAYMAP_OPTION_GPUINFO. |
int ADL2_Display_DisplayMapConfig_PossibleAddAndRemove | ( | ADL_CONTEXT_HANDLE | context, |
int | iAdapterIndex, | ||
int | iNumDisplayMap, | ||
ADLDisplayMap * | lpDisplayMap, | ||
int | iNumDisplayTarget, | ||
ADLDisplayTarget * | lpDisplayTarget, | ||
int * | lpNumPossibleAddTarget, | ||
ADLDisplayTarget ** | lppPossibleAddTarget, | ||
int * | lpNumPossibleRemoveTarget, | ||
ADLDisplayTarget ** | lppPossibleRemoveTarget | ||
) |
Function to validate a list of display configurations.
This function allows the user to input a potential displays map and its targets. The function can also be used to obtain a list of display targets that can be added to this given topology and a list of display targets that can be removed from this given topology.
[in] | context | Client's ADL context handle ADL_CONTEXT_HANDLE obtained from ADL2_Main_Control_Create. |
[in] | iAdapterIndex | The ADL index handle of the desired adapter. This function does not support the -1 value to test topologies across multiple GPUs. |
[in] | iNumDisplayMap | The number of display maps in this configuration. |
[in] | lpDisplayMap | The pointer to the display map information. Refer to the ADLDisplayMap structure for more information. |
[in] | iNumDisplayTarget | The number of display target sets in this configuration. |
[in] | lpDisplayTarget | The pointer to the display target information. Refer to the ADLDisplayTarget structure for more information. |
[out] | lpNumPossibleAddTarget | The pointer to the number of items in the array of lppPossibleAddTarget. |
[out] | lppPossibleAddTarget | The pointer to the array of the display targets that can be added in the given topology. Refer to the ADLDisplayTarget structure for more information. The user is responsible for freeing the memory for this array when it is no longer needed. |
[out] | lpNumPossibleRemoveTarget | The pointer to the number of items in the array of lppPossibleRemoveTarget. |
[out] | lppPossibleRemoveTarget | The pointer to the array of the display targets that can be removed from the given topology. Refer to the ADLDisplayTarget structure for more information. The user is responsible for freeing the memory for this array when it is no longer needed. |
int ADL2_Display_DisplayMapConfig_Set | ( | ADL_CONTEXT_HANDLE | context, |
int | iAdapterIndex, | ||
int | iNumDisplayMap, | ||
ADLDisplayMap * | lpDisplayMap, | ||
int | iNumDisplayTarget, | ||
ADLDisplayTarget * | lpDisplayTarget | ||
) |
Function to set the current display configuration.
This function sets the current display configurations for each display, including the controller and adapter mapped to each display. Possible display configurations are single, clone, extended desktop, and stretch mode. If clone mode is desired and the current display configuration is extended desktop mode, the function disables extended desktop mode in order to enable clone mode. If extended display mode is desired and the current display configuration is single mode, this function enables extended desktop.
[in] | context | Client's ADL context handle ADL_CONTEXT_HANDLE obtained from ADL2_Main_Control_Create. |
[in] | iAdapterIndex | The ADL index handle of the desired adapter. A value of -1 sets the displays in the system across multiple GPUs. |
[in] | iNumDisplayMap | The number of display maps to be set. |
[in] | lpDisplayMap | The pointer to the retrieved display map information. Refer to the ADLDisplayMap structure for more information. |
[in] | iNumDisplayTarget | The number of display target sets to be set. |
[in] | lpDisplayTarget | The pointer to the display target information. Refer to the ADLDisplayTarget structure for more information. |
int ADL2_Display_DisplayMapConfig_Validate | ( | ADL_CONTEXT_HANDLE | context, |
int | iAdapterIndex, | ||
int | iNumPossibleMap, | ||
ADLPossibleMap * | lpPossibleMaps, | ||
int * | lpNumPossibleMapResult, | ||
ADLPossibleMapResult ** | lppPossibleMapResult | ||
) |
Function to validate the list of the display configurations based on ADL Index.
This function validate the list of the display configurations for a specified input adapter. This function is applicable to all OS platforms.
[in] | context | Client's ADL context handle ADL_CONTEXT_HANDLE obtained from ADL2_Main_Control_Create. |
[in] | iAdapterIndex | The ADL index handle of the desired adapter. |
[in] | iNumPossibleMap | The number of possible maps to be validated. |
[in] | lpPossibleMaps | The list of possible maps to be validated. Refer to the ADLPossibleMap structure for more information. |
[out] | lpNumPossibleMapResult | The pointer to the number of validate result list. |
[out] | lppPossibleMapResult | The pointer to the pointer to validation result list. Refer to the ADLPossibleMapResult structure for more information. |
int ADL2_Display_ForcibleDisplay_Get | ( | ADL_CONTEXT_HANDLE | context, |
int | iAdapterIndex, | ||
int | iDisplayIndex, | ||
int * | lpStatus | ||
) |
Function to retrieve the forcible connected status of a display.
This function determines whether or not a display (i.e. CV) is set to be forcibly connected.
[in] | context | Client's ADL context handle ADL_CONTEXT_HANDLE obtained from ADL2_Main_Control_Create. |
[in] | iAdapterIndex | The ADL index handle of the desired adapter. |
[in] | iDisplayIndex | The desired display index. |
[out] | lpStatus | The forcible connected status of the display. ADL_TRUE : forced connected; ADL_FALSE : otherwise. |
int ADL2_Display_ForcibleDisplay_Set | ( | ADL_CONTEXT_HANDLE | context, |
int | iAdapterIndex, | ||
int | iDisplayIndex, | ||
int | iStatus | ||
) |
Function to set the forcible connected status of a display.
This function sets a display (i.e. TV) to be either forcibly connected or not forcibly connected.
[in] | context | Client's ADL context handle ADL_CONTEXT_HANDLE obtained from ADL2_Main_Control_Create. |
[in] | iAdapterIndex | The ADL index handle of the desired adapter. |
[in] | iDisplayIndex | The desired display index. |
[in] | iStatus | The desired connection status. ADL_TRUE : forced connected; ADL_FALSE : otherwise. |
int ADL2_Display_Modes_Get | ( | ADL_CONTEXT_HANDLE | context, |
int | iAdapterIndex, | ||
int | iDisplayIndex, | ||
int * | lpNumModes, | ||
ADLMode ** | lppModes | ||
) |
Function to retrieve the display mode information.
This function retrieves the current display mode information.
[in] | context | Client's ADL context handle ADL_CONTEXT_HANDLE obtained from ADL2_Main_Control_Create. |
[in] | iAdapterIndex | The ADL index handle of the desired adapter. A value of -1 retrieves all modes for the system across multiple GPUs. |
[in] | iDisplayIndex | The desired display index. If the index is -1, this field is ignored. |
[out] | lpNumModes | The pointer to the number of modes retrieved. |
[out] | lppModes | The pointer to the pointer to the retrieved display modes. Refer to the Display ADLMode structure for more information. |
int ADL2_Display_Modes_Set | ( | ADL_CONTEXT_HANDLE | context, |
int | iAdapterIndex, | ||
int | iDisplayIndex, | ||
int | iNumModes, | ||
ADLMode * | lpModes | ||
) |
Function to set display mode information.
This function sets the current display mode information.
[in] | context | Client's ADL context handle ADL_CONTEXT_HANDLE obtained from ADL2_Main_Control_Create. |
[in] | iAdapterIndex | The ADL index handle of the desired adapter. A value of -1 sets the modes across multiple GPUs. |
[in] | iDisplayIndex | The desired display index. If the index is -1, this field is ignored. |
[in] | iNumModes | The number of modes to be set. |
[in] | lpModes | The pointer to the display mode information to be set. Refer to the ADLMode structure for more information. |
int ADL2_Display_PossibleMapping_Get | ( | ADL_CONTEXT_HANDLE | context, |
int | iAdapterIndex, | ||
int | iNumberOfPresetMapping, | ||
ADLPossibleMapping * | lpPresetMappings, | ||
int | iEnquiryControllerIndex, | ||
int * | lpNumberOfEnquiryPossibleMappings, | ||
ADLPossibleMapping ** | lppEnquiryPossibleMappings | ||
) |
Function to retrieve the possible display mappings.
This function retrieves possible display mappings for an adapter.
[in] | context | Client's ADL context handle ADL_CONTEXT_HANDLE obtained from ADL2_Main_Control_Create. |
[in] | iAdapterIndex | The ADL index handle of the desired adapter. |
[in] | iNumberOfPresetMapping | The current number of preset mappings from the lpPresetMappings array. |
[in] | lpPresetMappings | The pointer to the buffer storing the current preset mappings. Refer to the ADLPossibleMapping structure for more information. |
[in] | iEnquiryControllerIndex | The desired controller index for mapping. |
[out] | lpNumberOfEnquiryPossibleMappings | The pointer to the number of possible mappings from the lppEnquiryPossibleMappings array. |
[out] | lppEnquiryPossibleMappings | The pointer to the pointer to the retrieved possible mapping buffer. Refer to the ADLPossibleMapping structure for more information. |
int ADL2_Display_PossibleMode_Get | ( | ADL_CONTEXT_HANDLE | context, |
int | iAdapterIndex, | ||
int * | lpNumModes, | ||
ADLMode ** | lppModes | ||
) |
Function to retrieve the OS possible modes list for an adapter (all OS platforms).
This function retrieves the OS possible modes list for a specified input adapter.
[in] | context | Client's ADL context handle ADL_CONTEXT_HANDLE obtained from ADL2_Main_Control_Create. |
[in] | iAdapterIndex | The ADL index handle of the desired adapter. |
[out] | lpNumModes | The pointer to the number of display modes from the lppModes array. |
[out] | lppModes | The pointer to the pointer to the retrieved possible display modes buffer. Refer to the ADLMode structure for more information. |
int ADL2_Workstation_EnableUnsupportedDisplayModes | ( | ADL_CONTEXT_HANDLE | context, |
int | iAdapterIndex | ||
) |
Function to set the Registry key "UnsupportedMonitorModesAllowed" when 10bit Pixel format is enabled from workstation aspect.
This function sets the above registry key to 1.
[in] | context | Client's ADL context handle ADL_CONTEXT_HANDLE obtained from ADL2_Main_Control_Create. |
[in] | iAdapterIndex | The ADL index handle of the desired adapter. |
int ADL_Adapter_Display_Caps | ( | int | iAdapterIndex, |
int * | lpNumDisplayCaps, | ||
ADLAdapterDisplayCap ** | lppAdapterDisplayCaps | ||
) |
Function to retrieve the adapter display manner capabilities based on ADL index.
This function retrieves the adapter display manner capabilities (e.g., single, clone, extended desktop, and stretch mode).
[in] | iAdapterIndex | The ADL index handle of the desired adapter. A value of -1 returns all adapter manner information for the system across all GPUs. |
[out] | lpNumDisplayCaps | The Number of display manner capabilities. |
[out] | lppAdapterDisplayCaps | The lists of display manner capabilities across all GPUs. Refer to the ADLAdapterDisplayCap structure for more information. |
int ADL_Adapter_NumberOfActivatableSources_Get | ( | int | iAdapterIndex, |
int * | lpNumSources, | ||
ADLActivatableSource ** | lppSources | ||
) |
Function to retrieve the number of Activatable sources based on ADL Index.
This function retrieves the activatable sources list for a specified input adapter. ActivatableSources is the number of displays that can be turned on simultaneously for the same GPU. For example, for AMD Radeon HD 4xxx Series and earlier this number is 2 while for ATI Radeon HD 5xxx Series the number could be 6 or 4.
[in] | iAdapterIndex | The ADL index handle of the desired adapter. |
[out] | lpNumSources | The pointer to the number of sources that can be activated. |
[out] | lppSources | The pointer to the pointer to the retrieved activatable sources buffer. Refer to the ADLActivatableSource structure for more information. |
int ADL_Display_DisplayMapConfig_Get | ( | int | iAdapterIndex, |
int * | lpNumDisplayMap, | ||
ADLDisplayMap ** | lppDisplayMap, | ||
int * | lpNumDisplayTarget, | ||
ADLDisplayTarget ** | lppDisplayTarget, | ||
int | iOptions | ||
) |
Function to retrieve current display map configurations.
This function retrieves the current display map configurations, including the controllers and adapters mapped to each display.
[in] | iAdapterIndex | The ADL index handle of the desired adapter. A value of -1 returns all display configurations for the system across multiple GPUs. |
[out] | lpNumDisplayMap | The pointer to the number of retrieved display maps. |
[out] | lppDisplayMap | The pointer to the pointer to the display manner information. Refer to the ADLDisplayMap structure for more information. |
[out] | lpNumDisplayTarget | The pointer to the display target sets retrieved. |
[out] | lppDisplayTarget | The pointer to the pointer to the display target buffer. Refer to the ADLDisplayTarget structure for more information. |
[in] | iOptions | The function option. ADL_DISPLAY_DISPLAYMAP_OPTION_GPUINFO. |
int ADL_Display_DisplayMapConfig_PossibleAddAndRemove | ( | int | iAdapterIndex, |
int | iNumDisplayMap, | ||
ADLDisplayMap * | lpDisplayMap, | ||
int | iNumDisplayTarget, | ||
ADLDisplayTarget * | lpDisplayTarget, | ||
int * | lpNumPossibleAddTarget, | ||
ADLDisplayTarget ** | lppPossibleAddTarget, | ||
int * | lpNumPossibleRemoveTarget, | ||
ADLDisplayTarget ** | lppPossibleRemoveTarget | ||
) |
Function to validate a list of display configurations.
This function allows the user to input a potential displays map and its targets. The function can also be used to obtain a list of display targets that can be added to this given topology and a list of display targets that can be removed from this given topology.
[in] | iAdapterIndex | The ADL index handle of the desired adapter. This function does not support the -1 value to test topologies across multiple GPUs. |
[in] | iNumDisplayMap | The number of display maps in this configuration. |
[in] | lpDisplayMap | The pointer to the display map information. Refer to the ADLDisplayMap structure for more information. |
[in] | iNumDisplayTarget | The number of display target sets in this configuration. |
[in] | lpDisplayTarget | The pointer to the display target information. Refer to the ADLDisplayTarget structure for more information. |
[out] | lpNumPossibleAddTarget | The pointer to the number of items in the array of lppPossibleAddTarget. |
[out] | lppPossibleAddTarget | The pointer to the array of the display targets that can be added in the given topology. Refer to the ADLDisplayTarget structure for more information. The user is responsible for freeing the memory for this array when it is no longer needed. |
[out] | lpNumPossibleRemoveTarget | The pointer to the number of items in the array of lppPossibleRemoveTarget. |
[out] | lppPossibleRemoveTarget | The pointer to the array of the display targets that can be removed from the given topology. Refer to the ADLDisplayTarget structure for more information. The user is responsible for freeing the memory for this array when it is no longer needed. |
int ADL_Display_DisplayMapConfig_Set | ( | int | iAdapterIndex, |
int | iNumDisplayMap, | ||
ADLDisplayMap * | lpDisplayMap, | ||
int | iNumDisplayTarget, | ||
ADLDisplayTarget * | lpDisplayTarget | ||
) |
Function to set the current display configuration.
This function sets the current display configurations for each display, including the controller and adapter mapped to each display. Possible display configurations are single, clone, extended desktop, and stretch mode. If clone mode is desired and the current display configuration is extended desktop mode, the function disables extended desktop mode in order to enable clone mode. If extended display mode is desired and the current display configuration is single mode, this function enables extended desktop.
[in] | iAdapterIndex | The ADL index handle of the desired adapter. A value of -1 sets the displays in the system across multiple GPUs. |
[in] | iNumDisplayMap | The number of display maps to be set. |
[in] | lpDisplayMap | The pointer to the retrieved display map information. Refer to the ADLDisplayMap structure for more information. |
[in] | iNumDisplayTarget | The number of display target sets to be set. |
[in] | lpDisplayTarget | The pointer to the display target information. Refer to the ADLDisplayTarget structure for more information. |
int ADL_Display_DisplayMapConfig_Validate | ( | int | iAdapterIndex, |
int | iNumPossibleMap, | ||
ADLPossibleMap * | lpPossibleMaps, | ||
int * | lpNumPossibleMapResult, | ||
ADLPossibleMapResult ** | lppPossibleMapResult | ||
) |
Function to validate the list of the display configurations based on ADL Index.
This function validate the list of the display configurations for a specified input adapter. This function is applicable to all OS platforms.
[in] | iAdapterIndex | The ADL index handle of the desired adapter. |
[in] | iNumPossibleMap | The number of possible maps to be validated. |
[in] | lpPossibleMaps | The list of possible maps to be validated. Refer to the ADLPossibleMap structure for more information. |
[out] | lpNumPossibleMapResult | The pointer to the number of validate result list. |
[out] | lppPossibleMapResult | The pointer to the pointer to validation result list. Refer to the ADLPossibleMapResult structure for more information. |
int ADL_Display_ForcibleDisplay_Get | ( | int | iAdapterIndex, |
int | iDisplayIndex, | ||
int * | lpStatus | ||
) |
Function to retrieve the forcible connected status of a display.
This function determines whether or not a display (i.e. CV) is set to be forcibly connected.
[in] | iAdapterIndex | The ADL index handle of the desired adapter. |
[in] | iDisplayIndex | The desired display index. |
[out] | lpStatus | The forcible connected status of the display. ADL_TRUE : forced connected; ADL_FALSE : otherwise. |
int ADL_Display_ForcibleDisplay_Set | ( | int | iAdapterIndex, |
int | iDisplayIndex, | ||
int | iStatus | ||
) |
Function to set the forcible connected status of a display.
This function sets a display (i.e. TV) to be either forcibly connected or not forcibly connected.
[in] | iAdapterIndex | The ADL index handle of the desired adapter. |
[in] | iDisplayIndex | The desired display index. |
[in] | iStatus | The desired connection status. ADL_TRUE : forced connected; ADL_FALSE : otherwise. |
int ADL_Display_Modes_Get | ( | int | iAdapterIndex, |
int | iDisplayIndex, | ||
int * | lpNumModes, | ||
ADLMode ** | lppModes | ||
) |
Function to retrieve the display mode information.
This function retrieves the current display mode information.
[in] | iAdapterIndex | The ADL index handle of the desired adapter. A value of -1 retrieves all modes for the system across multiple GPUs. |
[in] | iDisplayIndex | The desired display index. If the index is -1, this field is ignored. |
[out] | lpNumModes | The pointer to the number of modes retrieved. |
[out] | lppModes | The pointer to the pointer to the retrieved display modes. Refer to the Display ADLMode structure for more information. |
int ADL_Display_Modes_Set | ( | int | iAdapterIndex, |
int | iDisplayIndex, | ||
int | iNumModes, | ||
ADLMode * | lpModes | ||
) |
Function to set display mode information.
This function sets the current display mode information.
[in] | iAdapterIndex | The ADL index handle of the desired adapter. A value of -1 sets the modes across multiple GPUs. |
[in] | iDisplayIndex | The desired display index. If the index is -1, this field is ignored. |
[in] | iNumModes | The number of modes to be set. |
[in] | lpModes | The pointer to the display mode information to be set. Refer to the ADLMode structure for more information. |
int ADL_Display_PossibleMapping_Get | ( | int | iAdapterIndex, |
int | iNumberOfPresetMapping, | ||
ADLPossibleMapping * | lpPresetMappings, | ||
int | iEnquiryControllerIndex, | ||
int * | lpNumberOfEnquiryPossibleMappings, | ||
ADLPossibleMapping ** | lppEnquiryPossibleMappings | ||
) |
Function to retrieve the possible display mappings.
This function retrieves possible display mappings for an adapter.
[in] | iAdapterIndex | The ADL index handle of the desired adapter. |
[in] | iNumberOfPresetMapping | The current number of preset mappings from the lpPresetMappings array. |
[in] | lpPresetMappings | The pointer to the buffer storing the current preset mappings. Refer to the ADLPossibleMapping structure for more information. |
[in] | iEnquiryControllerIndex | The desired controller index for mapping. |
[out] | lpNumberOfEnquiryPossibleMappings | The pointer to the number of possible mappings from the lppEnquiryPossibleMappings array. |
[out] | lppEnquiryPossibleMappings | The pointer to the pointer to the retrieved possible mapping buffer. Refer to the ADLPossibleMapping structure for more information. |
int ADL_Display_PossibleMode_Get | ( | int | iAdapterIndex, |
int * | lpNumModes, | ||
ADLMode ** | lppModes | ||
) |
Function to retrieve the OS possible modes list for an adapter (all OS platforms).
This function retrieves the OS possible modes list for a specified input adapter.
[in] | iAdapterIndex | The ADL index handle of the desired adapter. |
[out] | lpNumModes | The pointer to the number of display modes from the lppModes array. |
[out] | lppModes | The pointer to the pointer to the retrieved possible display modes buffer. Refer to the ADLMode structure for more information. |
int ADL_Workstation_EnableUnsupportedDisplayModes | ( | int | iAdapterIndex | ) |
Function to set the Registry key "UnsupportedMonitorModesAllowed" when 10bit Pixel format is enabled from workstation aspect.
This function sets the above registry key to 1.
[in] | iAdapterIndex | The ADL index handle of the desired adapter. |