AGS 6.3

Author: kurbeco

LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2023 Advanced Micro Devices, Inc. All rights reserved.
+Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,4 +1,4 @@
-Copyright (c) 2023 Advanced Micro Devices, Inc. All rights reserved.
+Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

ags_lib/LICENSE.txt

@@ -1,5 +1,5 @@
 //
-// Copyright (c) 2023 Advanced Micro Devices, Inc. All rights reserved.
+// Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to deal

ags_lib/doc/amd_ags.chm

@@ -1,5 +1,5 @@
 //
-// Copyright (c) 2023 Advanced Micro Devices, Inc. All rights reserved.
+// Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to deal
@@ -98,7 +98,6 @@ RWByteAddressBuffer AmdExtD3DShaderIntrinsicsUAV : register(u0, AmdExtD3DShaderI
 #define AmdExtD3DShaderIntrinsicsOpcode_ShaderClock             0x1f
 #define AmdExtD3DShaderIntrinsicsOpcode_ShaderRealtimeClock     0x20
 
-
 /**
 ***********************************************************************************************************************
 *   Intrinsic opcode phases.

ags_lib/hlsl/ags_shader_intrinsics_dx11.hlsl

@@ -3,9 +3,9 @@ set(CMAKE_GENERATOR_PLATFORM x64)
 set(CMAKE_CONFIGURATION_TYPES Debug Release)
 
 if(AGS_INTERNAL_DEBUG)
-project(ags_sample_internal VERSION 6.2.0)
+project(ags_sample_internal VERSION 6.3.0)
 else()
-project(ags_sample VERSION 6.2.0)
+project(ags_sample VERSION 6.3.0)
 endif()
 
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/bin)

ags_lib/hlsl/ags_shader_intrinsics_dx12.hlsl

@@ -1,5 +1,5 @@
 //
-// Copyright (c) 2023 Advanced Micro Devices, Inc. All rights reserved.
+// Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to deal
@@ -68,15 +68,16 @@ void PrintDisplayInfo( const AGSGPUInfo& gpuInfo )
             "Vega",
             "RDNA",
             "RDNA2",
-            "RDNA3"
+            "RDNA3",
+            "RDNA4"
         };
 
-        static_assert( _countof( asicFamily ) == AGSDeviceInfo::AsicFamily_Count, "asic family table out of date" );
+        static_assert( _countof( asicFamily ) == AGSAsicFamily_Count, "asic family table out of date" );
 
         if ( device.vendorId == 0x1002 )
         {
             char wgpInfo[ 256 ] = {};
-            if ( device.asicFamily >= AGSDeviceInfo::AsicFamily_RDNA )
+            if ( device.asicFamily >= AGSAsicFamily_RDNA )
             {
                 sprintf_s( wgpInfo, ", %d WGPs", device.numWGPs );
             }
@@ -154,7 +155,7 @@ void PrintDisplayInfo( const AGSGPUInfo& gpuInfo )
 }
 
 
-void testDriver( const char* driver, unsigned int driverToCompareAgainst )
+void testRadeonSoftwareVersion( const char* driver, unsigned int driverToCompareAgainst )
 {
     AGSDriverVersionResult result = agsCheckDriverVersion( driver, driverToCompareAgainst );
 
@@ -172,6 +173,7 @@ void testDriver( const char* driver, unsigned int driverToCompareAgainst )
     }
 }
 
+
 int main(int , char**)
 {
     // Enable run-time memory check for debug builds.
@@ -201,16 +203,19 @@ int main(int , char**)
         PrintDisplayInfo( gpuInfo );
         printf( "-----------------------------------------------------------------\n" );
 
-        if( 0 )
+        if ( 0 )
         {
+            // It should be noted that the Radeon Software Version can be empty, or just have the internal driver string in this field.
+            // Therefore, it is recommended to use the internal driver version as a minimum driver version check.
             printf( "\n" );
-            testDriver( gpuInfo.radeonSoftwareVersion, AGS_MAKE_VERSION( 20, 1, 0 ) );
-            testDriver( "18.8.randombetadriver", AGS_MAKE_VERSION( 18, 8, 2 ) );
-            testDriver( "18.8.123randomdriver", AGS_MAKE_VERSION( 18, 8, 2 ) );
-            testDriver( "18.9.randomdriver", AGS_MAKE_VERSION( 18, 8, 2 ) );
-            testDriver( "18.8.2", AGS_MAKE_VERSION( 18, 8, 2 ) );
-            testDriver( "18.8.2", AGS_MAKE_VERSION( 18, 8, 1 ) );
-            testDriver( "18.8.2", AGS_MAKE_VERSION( 18, 8, 3 ) );
+            testRadeonSoftwareVersion( gpuInfo.radeonSoftwareVersion, AGS_MAKE_VERSION( 24, 1, 1 ) );
+            testRadeonSoftwareVersion( "24.1.randombetadriver", AGS_MAKE_VERSION( 24, 1, 1 ) );
+            testRadeonSoftwareVersion( "24.1.123randomdriver", AGS_MAKE_VERSION( 24, 1, 1 ) );
+            testRadeonSoftwareVersion( "24.2.randomdriver", AGS_MAKE_VERSION( 24, 1, 1 ) );
+            testRadeonSoftwareVersion( "24.Q1", AGS_MAKE_VERSION( 24, 1, 1 ) );
+            testRadeonSoftwareVersion( "24.1.1", AGS_MAKE_VERSION( 24, 1, 1 ) );
+            testRadeonSoftwareVersion( "24.1.1", AGS_MAKE_VERSION( 23, 12, 1 ) );
+            testRadeonSoftwareVersion( "24.1.1", AGS_MAKE_VERSION( 25, 2, 4 ) );
             printf( "\n" );
         }
 

ags_lib/inc/amd_ags.h

@@ -2,7 +2,7 @@ cmake_minimum_required(VERSION 3.15)
 set(CMAKE_GENERATOR_PLATFORM x64)
 set(CMAKE_CONFIGURATION_TYPES Debug Release)
 
-project(crossfire_sample VERSION 6.2.0)
+project(crossfire_sample VERSION 6.3.0)
 
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/bin)
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_RELEASE ${CMAKE_RUNTIME_OUTPUT_DIRECTORY})

ags_lib/lib/amd_ags_x64.dll

@@ -1,5 +1,5 @@
 //
-// Copyright (c) 2016 Advanced Micro Devices, Inc. All rights reserved.
+// Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to deal

ags_lib/lib/amd_ags_x64.lib

@@ -1,5 +1,5 @@
 //
-// Copyright (c) 2016 Advanced Micro Devices, Inc. All rights reserved.
+// Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to deal

ags_lib/lib/amd_ags_x64_2015_MD.lib

@@ -1,5 +1,5 @@
 //
-// Copyright (c) 2016 Advanced Micro Devices, Inc. All rights reserved.
+// Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to deal

ags_lib/lib/amd_ags_x64_2015_MDd.lib

@@ -1,5 +1,5 @@
 //
-// Copyright (c) 2016 Advanced Micro Devices, Inc. All rights reserved.
+// Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to deal

ags_lib/lib/amd_ags_x64_2015_MT.lib

@@ -3,9 +3,9 @@ set(CMAKE_GENERATOR_PLATFORM x64)
 set(CMAKE_CONFIGURATION_TYPES Debug Release)
 
 if(AGS_INTERNAL_DEBUG)
-project(ExtensionsSample12_internal VERSION 6.2.0)
+project(ExtensionsSample12_internal VERSION 6.3.0)
 else()
-project(ExtensionsSample12 VERSION 6.2.0)
+project(ExtensionsSample12 VERSION 6.3.0)
 endif()
 
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/bin)

ags_lib/lib/amd_ags_x64_2015_MTd.lib

@@ -1,5 +1,5 @@
 //
-// Copyright (c) 2023 Advanced Micro Devices, Inc. All rights reserved.
+// Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to deal
@@ -28,7 +28,7 @@
 #include <d3dcompiler.h>
 #include <algorithm>
 #include <assert.h>
-
+#include <vector>
 #include "Window.h"
 
 #ifdef max
@@ -82,7 +82,7 @@ void D3D12Sample::PrepareRender ()
     commandList->RSSetScissorRects (1, &m_rectScissor);
 
     // Transition back buffer
-    D3D12_RESOURCE_BARRIER barrier;
+    D3D12_RESOURCE_BARRIER barrier = {};
     barrier.Transition.pResource = m_renderTargets [m_currentBackBuffer].Get ();
     barrier.Type = D3D12_RESOURCE_BARRIER_TYPE_TRANSITION;
     barrier.Flags = D3D12_RESOURCE_BARRIER_FLAG_NONE;
@@ -119,7 +119,7 @@ void D3D12Sample::Render ()
 void D3D12Sample::FinalizeRender ()
 {
     // Transition the swap chain back to present
-    D3D12_RESOURCE_BARRIER barrier;
+    D3D12_RESOURCE_BARRIER barrier = {};
     barrier.Transition.pResource = m_renderTargets [m_currentBackBuffer].Get ();
     barrier.Type = D3D12_RESOURCE_BARRIER_TYPE_TRANSITION;
     barrier.Flags = D3D12_RESOURCE_BARRIER_FLAG_NONE;
@@ -197,7 +197,7 @@ void D3D12Sample::SetupRenderTargets ()
 
     for (int i = 0; i < GetQueueSlotCount (); ++i)
     {
-        D3D12_RENDER_TARGET_VIEW_DESC viewDesc;
+        D3D12_RENDER_TARGET_VIEW_DESC viewDesc = {};
         viewDesc.Format = DXGI_FORMAT_R8G8B8A8_UNORM_SRGB;
         viewDesc.ViewDimension = D3D12_RTV_DIMENSION_TEXTURE2D;
         viewDesc.Texture2D.MipSlice = 0;
@@ -321,6 +321,7 @@ void D3D12Sample::Shutdown ()
     }
 }
 
+
 ///////////////////////////////////////////////////////////////////////////////
 void D3D12Sample::CreateDeviceAndSwapChain ()
 {
@@ -366,6 +367,12 @@ void D3D12Sample::CreateDeviceAndSwapChain ()
             AGSDX12ExtensionParams extensionParams = {};
             AGSDX12ReturnedParams returnedParams = {};
 
+            // Example use of the AGS app registration API
+            extensionParams.pAppName = L"AGS DX12 Extensions Sample";
+            extensionParams.appVersion = AGS_MAKE_VERSION( 1, 0, 0 );
+            extensionParams.pEngineName = L"DX12 Sample Framework";
+            extensionParams.engineVersion = AGS_MAKE_VERSION( 1, 0, 0 );
+
             // Create AGS Device
             //
             AGSReturnCode rc = agsDriverExtensionsDX12_CreateDevice(m_agsContext, &creationParams, &extensionParams, &returnedParams);
@@ -387,6 +394,19 @@ void D3D12Sample::CreateDeviceAndSwapChain ()
                 {
                     Print( "\tShader clock intrinsics available\n" );
                 }
+
+                // {d5a2a91b-7003-4f12-89de-209beb51fb94}
+                static const GUID IID_AGSContextData = {0xd5a2a91b, 0x7003, 0x4f12, {0x89, 0xde, 0x20, 0x9b, 0xeb, 0x51, 0xfb, 0x94}};
+
+                AGSContext* retrievedContext = nullptr;
+                UINT contextPointerSize = sizeof( retrievedContext );
+                if ( m_device->GetPrivateData( IID_AGSContextData, &contextPointerSize, &retrievedContext ) == S_OK )
+                {
+                    if ( contextPointerSize == sizeof( m_agsContext ) && m_agsContext == retrievedContext )
+                    {
+                        Print( "Retrieved the correct AGS context from the D3D device\n" );
+                    }
+                }
             }
             else
             {

ags_lib/lib/amd_ags_x64_2017_MD.lib

@@ -1,5 +1,5 @@
 //
-// Copyright (c) 2023 Advanced Micro Devices, Inc. All rights reserved.
+// Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to deal
@@ -57,25 +57,25 @@ class D3D12Sample
         return QUEUE_SLOT_COUNT;
     }
 
-    D3D12_VIEWPORT m_viewport;
-    D3D12_RECT m_rectScissor;
-    Microsoft::WRL::ComPtr<IDXGISwapChain> m_swapChain;
-    Microsoft::WRL::ComPtr<ID3D12Device> m_device;
-    Microsoft::WRL::ComPtr<ID3D12Resource> m_renderTargets [QUEUE_SLOT_COUNT];
-    Microsoft::WRL::ComPtr<ID3D12CommandQueue> m_commandQueue;
+    D3D12_VIEWPORT m_viewport = {};
+    D3D12_RECT m_rectScissor = {};
+    Microsoft::WRL::ComPtr<IDXGISwapChain> m_swapChain = {};
+    Microsoft::WRL::ComPtr<ID3D12Device> m_device = {};
+    Microsoft::WRL::ComPtr<ID3D12Resource> m_renderTargets [QUEUE_SLOT_COUNT] = {};
+    Microsoft::WRL::ComPtr<ID3D12CommandQueue> m_commandQueue = {};
 
-    HANDLE m_frameFenceEvents [QUEUE_SLOT_COUNT];
-    Microsoft::WRL::ComPtr<ID3D12Fence> m_frameFences [QUEUE_SLOT_COUNT];
-    UINT64 m_currentFenceValue;
-    UINT64 m_fenceValues[QUEUE_SLOT_COUNT];
+    HANDLE m_frameFenceEvents [QUEUE_SLOT_COUNT] = {};
+    Microsoft::WRL::ComPtr<ID3D12Fence> m_frameFences [QUEUE_SLOT_COUNT] = {};
+    UINT64 m_currentFenceValue = 0;
+    UINT64 m_fenceValues[QUEUE_SLOT_COUNT] = {};
 
-    Microsoft::WRL::ComPtr<ID3D12DescriptorHeap> m_renderTargetDescriptorHeap;
+    Microsoft::WRL::ComPtr<ID3D12DescriptorHeap> m_renderTargetDescriptorHeap = {};
 
-    Microsoft::WRL::ComPtr<ID3D12RootSignature> m_rootSignature;
+    Microsoft::WRL::ComPtr<ID3D12RootSignature> m_rootSignature = {};
 
     AGSContext*                                 m_agsContext = nullptr;
     AGSGPUInfo                                  m_agsGPUInfo = {};
-    AGSDX12ReturnedParams::ExtensionsSupported  m_agsDeviceExtensions = {};
+    AGSDX12ExtensionsSupported                  m_agsDeviceExtensions = {};
 
     virtual void InitializeImpl(ID3D12GraphicsCommandList* uploadCommandList) = 0;
     virtual void ShutdownImpl() = 0;

ags_lib/lib/amd_ags_x64_2017_MDd.lib

@@ -1,5 +1,5 @@
 //
-// Copyright (c) 2023 Advanced Micro Devices, Inc. All rights reserved.
+// Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to deal

ags_lib/lib/amd_ags_x64_2017_MT.lib

@@ -1,5 +1,5 @@
 //
-// Copyright (c) 2023 Advanced Micro Devices, Inc. All rights reserved.
+// Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to deal

ags_lib/lib/amd_ags_x64_2017_MTd.lib

@@ -1,5 +1,5 @@
 //
-// Copyright (c) 2023 Advanced Micro Devices, Inc. All rights reserved.
+// Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to deal

ags_lib/lib/amd_ags_x64_2019_MD.lib

@@ -1,5 +1,5 @@
 //
-// Copyright (c) 2023 Advanced Micro Devices, Inc. All rights reserved.
+// Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to deal

ags_lib/lib/amd_ags_x64_2019_MDd.lib

@@ -1,5 +1,5 @@
 //
-// Copyright (c) 2023 Advanced Micro Devices, Inc. All rights reserved.
+// Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to deal

ags_lib/lib/amd_ags_x64_2019_MT.lib

@@ -1,5 +1,5 @@
 //
-// Copyright (c) 2023 Advanced Micro Devices, Inc. All rights reserved.
+// Copyright (c) 2025 Advanced Micro Devices, Inc. All rights reserved.
 //
 // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to deal

ags_lib/lib/amd_ags_x64_2019_MTd.lib

@@ -2,7 +2,7 @@ cmake_minimum_required(VERSION 3.15)
 set(CMAKE_GENERATOR_PLATFORM x64)
 set(CMAKE_CONFIGURATION_TYPES Debug Release)
 
-project(eyefinity_sample VERSION 6.2.0)
+project(eyefinity_sample VERSION 6.3.0)
 
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/bin)
 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_RELEASE ${CMAKE_RUNTIME_OUTPUT_DIRECTORY})