DisplayFreeSync

Demonstrates how to obtain the display FreeSync when programming with ADLX and perform related operations.

Command Prompts

Command Prompt Description
1 Display FreeSync support.
2 Get FreeSync state.
3 Set current FreeSync to disabled.
4 Set current FreeSync to enabled.
M/m Display the command prompt menu.
Q/q Terminate the application.

Sample Path

/Samples/CPP/Display/DisplayFreeSync

Code

Copied!

//
// Copyright (c) 2021 - 2024 Advanced Micro Devices, Inc. All rights reserved.
//
//-------------------------------------------------------------------------------------------------


#include "SDK/ADLXHelper/Windows/Cpp/ADLXHelper.h"
#include "SDK/Include/IDisplaySettings.h"
#include "SDK/Include/IDisplays.h"
#include <iostream>
#include <string>

// Use ADLX namespace
using namespace adlx;

// ADLXHelper instance.
// No outstanding interfaces from ADLX must exist when ADLX destory.
// so we use global variables to ensure the valid of the interface.
static ADLXHelper g_ADLXHelp;

// Dispalay displayFreeSync support
void ShowDisplayFreeSyncSupport(const IADLXDisplayServicesPtr& displayService, const IADLXDisplayPtr& display);

// Display current displayFreeSync state
void GetFreeSyncState(const IADLXDisplayServicesPtr& displayService, const IADLXDisplayPtr& display);

// Set displayFreeSync
void SetFreeSyncState(const IADLXDisplayServicesPtr& displayService, const IADLXDisplayPtr& display, const int key);

// Main menu
void MainMenu();

// Menu action control
void MenuControl(const IADLXDisplayServicesPtr& displayService, const IADLXDisplayPtr& display);

// Wait for exit with error message
int WaitAndExit(const char* msg, const int retCode);

int main()
{
    // Define return code
    ADLX_RESULT  res = ADLX_FAIL ;

    // Initialize ADLX
    res = g_ADLXHelp.Initialize();
    if (ADLX_SUCCEEDED (res))
    {
        // Get display service
        IADLXDisplayServicesPtr displayService;
        res = g_ADLXHelp.GetSystemServices()->GetDisplaysServices(&displayService);
        if (ADLX_SUCCEEDED (res))
        {
            // Get display list
            IADLXDisplayListPtr displayList;
            res = displayService->GetDisplays(&displayList);
            if (ADLX_SUCCEEDED  (res))
            {
                // Inspect for the first display in the list
                adlx_uint it = 0;
                IADLXDisplayPtr display;
                res = displayList->At(it, &display);
                if (ADLX_SUCCEEDED (res))
                {
                    // Display main menu options
                    MainMenu();
                    // Get and parse the selection
                    MenuControl(displayService, display);
                }
            }
            else
            {
                std::cout << "Failed to get the display list" << std::endl;
            }
        }
        else
        {
            // Destroy ADLX
            res = g_ADLXHelp.Terminate();
            std::cout << "Destroy ADLX res: " << res << std::endl;
            return WaitAndExit("Failed to get the display services", 0);
        }
    }
    else
    {
        return WaitAndExit("ADLX initialization failed", 0);
    }

    // Destroy ADLX
    res = g_ADLXHelp.Terminate();
    std::cout << "Destroy ADLX result: " << res << std::endl;

    // Pause to see the print out
    system("Pause");

    return 0;
}

void ShowDisplayFreeSyncSupport(const IADLXDisplayServicesPtr& displayService, const IADLXDisplayPtr& display)
{
    IADLXDisplayFreeSyncPtr displayFreeSync;
    ADLX_RESULT  res = displayService->GetFreeSync(display, &displayFreeSync);
    if (ADLX_SUCCEEDED (res))
    {
        std::cout << "  === Get FreeSync Supported ===" << std::endl;
        adlx_bool supported = false;
        res = displayFreeSync->IsSupported(&supported);
        std::cout << "\\tIsSupported, result: " << res << " supported: " << (supported ? "true" : "false") << std::endl;
    }
}

void GetFreeSyncState(const IADLXDisplayServicesPtr& displayService, const IADLXDisplayPtr& display)
{
    IADLXDisplayFreeSyncPtr displayFreeSync;
    ADLX_RESULT  res = displayService->GetFreeSync(display, &displayFreeSync);
    if (ADLX_SUCCEEDED (res))
    {
        std::cout << "  === Get FreeSync Enabled ===" << std::endl;
        adlx_bool enabled = false;
        res = displayFreeSync->IsEnabled(&enabled);
        std::cout << "\\tGetEnabled, result: " << res << " enabled: " << enabled << std::endl;
    }
}

void SetFreeSyncState(const IADLXDisplayServicesPtr& displayService, const IADLXDisplayPtr& display, const int key)
{
    IADLXDisplayFreeSyncPtr displayFreeSync;
    ADLX_RESULT  res = displayService->GetFreeSync(display, &displayFreeSync);
    if (ADLX_SUCCEEDED (res))
    {
        ADLX_RESULT  res = ADLX_FAIL ;
        switch (key)
        {
            // Set FreeSync disabled
        case 0:
            std::cout << "  === Set FreeSync Enabled: false" << std::endl;
            res = displayFreeSync->SetEnabled(false);
            break;
            // Set FreeSync enabled
        case 1:
            std::cout << "  === Set FreeSync Enabled: true" << std::endl;
            res = displayFreeSync->SetEnabled(true);
            break;
        default:
            break;
        }
        std::cout << "\\tReturn code is: " << res <<" (0 means success)" << std::endl;
    }
}

void MainMenu()
{
    std::cout << "\\tChoose from following options" << std::endl;

    std::cout << "\\t->Press 1 to display FreeSync support" << std::endl;

    std::cout << "\\t->Press 2 to get FreeSync state" << std::endl;

    std::cout << "\\t->Press 3 to set current FreeSync to disabled" << std::endl;
    std::cout << "\\t->Press 4 to set current FreeSync to enabled" << std::endl;

    std::cout << "\\t->Press Q/q to terminate the application" << std::endl;
    std::cout << "\\t->Press M/m to display main menu options" << std::endl;
}

// Menu action control
void MenuControl(const IADLXDisplayServicesPtr& displayService, const IADLXDisplayPtr& display)
{
    int num = 0;
    while ((num = getchar()) != 'q' && num != 'Q')
    {
        switch (num)
        {
            // Display displayFreeSync support
        case '1':
            ShowDisplayFreeSyncSupport(displayService, display);
            break;

            // Display current displayFreeSync state
        case '2':
            GetFreeSyncState(displayService, display);
            break;

            // Set displayFreeSync
        case '3':
        case '4':
            SetFreeSyncState(displayService, display, num - '3');
            break;

            // Display main menu options
        case 'm':
        case 'M':
            MainMenu();
            break;
        default:
            break;
        }
    }
}

// Wait for exit with error message
int WaitAndExit(const char* msg, const int retCode)
{
    // Printout the message and pause to see it before returning the desired code
    if (nullptr != msg)
        std::cout << msg << std::endl;

    system("Pause");
    return retCode;
}