Disable radeonSoftwareVersion field until needed driver update is public

The radeonSoftwareVersion field is not currently working correctly. This
update disables it while we wait for the necessary driver updates.

This update also changes WindowsTargetPlatformVersion for Visual Studio
2015 to target the Windows 8.1 SDK. The Windows 10 SDK is not installed
by default with Visual Studio 2015, and since AGS is based on DirectX 11
(and not DirectX 12), it does not need the Windows 10 SDK. The 8.1 SDK
is installed by default, so just target it, to avoid adding an
unnecessary dependency on an optional component of Visual Studio.

Author: jstewart-amd

.gitignore

@@ -0,0 +1,50 @@
+## Ignore Visual Studio temporary files, build results, etc.
+
+# User-specific files
+*.suo
+*.user
+
+# Build results
+VS*/
+[Dd]esktop_*/
+AGSSample_Debug_*.*
+AGSSample_Release_*.*
+ags_sample/bin/
+CrossfireSample_Debug_*.*
+CrossfireSample_Release_*.*
+crossfire_sample/bin/
+EyefinitySample_Debug_*.*
+EyefinitySample_Release_*.*
+eyefinity_sample/bin/
+
+# Visual Studo 2015 cache/options directory
+.vs/
+
+# Visual C++ cache files
+ipch/
+*.aps
+*.ncb
+*.opensdf
+*.sdf
+*.cachefile
+*.opendb
+
+# Visual Studio profiler
+*.psess
+*.vsp
+*.vspx
+
+# Installshield output folder
+[Ee]xpress/
+
+# Backup & report files from converting an old project file
+# to a newer Visual Studio version. Backup files are not needed,
+# because we have git ;-)
+_UpgradeReport_Files/
+Backup*/
+UpgradeLog*.XML
+UpgradeLog*.htm
+
+# Shader cache
+[Bb]in/Shaders/
+HashDigest.html

CHANGELOG.md

@@ -0,0 +1,11 @@
+# AMD AGS SDK Changelog
+
+See `ags_lib\CHANGELOG.md` for changes to the core AGS library. 
+
+### v3.1.1 - 2016-01-28
+* Display library version number in ags_sample
+* Do not display `radeonSoftwareVersion` in ags_sample while we wait for a needed driver update
+* Set `WindowsTargetPlatformVersion` to 8.1 for VS2015, to eliminate unnecessary dependency on optional Windows 10 SDK
+
+### v3.1.0 - 2016-01-26
+* Initial release on GitHub

README.md

@@ -1,7 +1,8 @@
 # AMD AGS SDK
 <img src="ags_lib/doc/amd_logo_black.png" width="512" height="123" />
 
-The AMD GPU Services (AGS) library provides software developers with the ability to query AMD GPU software and hardware state information that is not normally available through standard operating systems or graphic APIs. Version 3.1 of the library includes support for querying graphics driver version info, GPU performance, Crossfire&trade; (AMD's multi-GPU rendering technology) configuration info, and Eyefinity (AMD's multi-display rendering technology) configuration info. AGS also exposes the explicit Crossfire API, as well as additional functionality supported in the AMD DirectX 11 driver.
+The AMD GPU Services (AGS) library provides software developers with the ability to query AMD GPU software and hardware state information that is not normally available through standard operating systems or graphic APIs. Version 3.1 of the library includes support for querying graphics driver version info, GPU performance, Crossfire&trade; (AMD's multi-GPU rendering technology) configuration info, and Eyefinity (AMD's multi-display rendering technology) configuration info. AGS also exposes the explicit Crossfire API, as well as additional functionality supported in the AMD driver for DirectX 11.
+
 In addition to the library itself, the AGS SDK includes several samples to demonstrate use of the library.
 
 ### What's new in AGS
@@ -15,14 +16,15 @@ AGS now returns a lot more information from the GPU in addition to exposing the
 * New explicit Crossfire API
   * Provides the ability to control resource transfers between GPUs in Crossfire configuration in DirectX 11
   * Allows improved performance in multi-GPU configurations
-* AGS provides access to some of the extensions available in the DirectX 11 driver:
+* AGS provides access to some of the extensions available in the AMD driver for DirectX 11:
   * Quad List primitive type
   * UAV overlap
   * Depth bounds test
   * Multi-draw indirect
 
 ### Prerequisites
 * AMD Radeon&trade; GCN-based GPU (HD 7000 series or newer)
+  * Or other DirectX&reg; 11 compatible GPU with Shader Model 5 support<sup>[1](#ags-sdk-footnote1)</sup> 
 * 64-bit Windows&reg; 7 (SP1 with the [Platform Update](https://msdn.microsoft.com/en-us/library/windows/desktop/jj863687.aspx)), Windows&reg; 8.1, or Windows&reg; 10
 * Visual Studio&reg; 2012, Visual Studio&reg; 2013, or Visual Studio&reg; 2015
 
@@ -53,3 +55,6 @@ For Visual Studio 2015, this version of Premake adds the `WindowsTargetPlatformV
 ### Attribution
 * AMD, the AMD Arrow logo, Radeon, Crossfire, and combinations thereof are either registered trademarks or trademarks of Advanced Micro Devices, Inc. in the United States and/or other countries.
 * Microsoft, DirectX, Visual Studio, and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.
+
+### Notes
+<a name="ags-sdk-footnote1">1</a>: While the AGS SDK samples will run on non-AMD hardware, they will be of limited usefulness, since the purpose of AGS is to provide convenient access to AMD-specific information and extensions.

ags_sample/build/AGSSample_2015.vcxproj

@@ -16,7 +16,7 @@
     <Keyword>Win32Proj</Keyword>
     <RootNamespace>AGSSample</RootNamespace>
     <ProjectName>AGSSample</ProjectName>
-    <WindowsTargetPlatformVersion>10.0.10240.0</WindowsTargetPlatformVersion>
+    <WindowsTargetPlatformVersion>8.1</WindowsTargetPlatformVersion>
   </PropertyGroup>
   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'" Label="Configuration">

ags_sample/src/AGSSample.cpp

@@ -32,6 +32,7 @@
 #include <crtdbg.h>
 #include <amd_ags.h>
 
+
 #pragma warning( disable : 4100 ) // disable unreference formal parameter warnings for /W4 builds
 
 void GetEyefinityInfo( AGSContext* context, int primaryDisplayIndex )
@@ -122,12 +123,11 @@ int main(int argc, char* argv[])
 
     if ( agsInit( &agsContext, &info ) == AGS_SUCCESS )
     {
-        printf( "AGS Library initialized\n\n" );
+        printf( "AGS Library initialized: v%d.%d.%d\n\n", AMD_AGS_LIB_VERSION_MAJOR, AMD_AGS_LIB_VERSION_MINOR, AMD_AGS_LIB_VERSION_PATCH );
         printf( "-----------------------------------------------------------------\n" );
 
         printf( "%s, device id: 0x%04X, revision id: 0x%02X\n", info.adapterString ? info.adapterString : "unknown GPU", info.deviceId, info.revisionId );
         printf( "Driver version:            %s\n", info.driverVersion );
-        printf( "Radeon Software:           %s\n", info.radeonSoftwareVersion );
         printf( "-----------------------------------------------------------------\n" );
 
         printf( "Is %sGCN, %d CUs, core clock %d MHz, memory clock %d MHz, %.1f Tflops\n", info.version == AGSGPUInfo::ArchitectureVersion_GCN ? "" : "not ", info.iNumCUs, info.iCoreClock, info.iMemoryClock, info.fTFlops );

crossfire_sample/build/CrossfireSample_2015.vcxproj

@@ -16,7 +16,7 @@
     <Keyword>Win32Proj</Keyword>
     <RootNamespace>CrossfireSample</RootNamespace>
     <ProjectName>CrossfireSample</ProjectName>
-    <WindowsTargetPlatformVersion>10.0.10240.0</WindowsTargetPlatformVersion>
+    <WindowsTargetPlatformVersion>8.1</WindowsTargetPlatformVersion>
   </PropertyGroup>
   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'" Label="Configuration">

crossfire_sample/src/CFXAPISample.h

@@ -19,8 +19,8 @@
 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 // THE SOFTWARE.
 //
-#ifndef CFX_API_SAMPLE_MAIN_H
-#define CFX_API_SAMPLE_MAIN_H
+#ifndef AMD_AGS_SDK_CFX_API_SAMPLE_MAIN_H_
+#define AMD_AGS_SDK_CFX_API_SAMPLE_MAIN_H_
 
 #include <d3d11.h>
 #include <wrl.h>

crossfire_sample/src/Window.h

@@ -19,8 +19,8 @@
 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 // THE SOFTWARE.
 //
-#ifndef CFX_API_SAMPLE_WINDOW_H
-#define CFX_API_SAMPLE_WINDOW_H
+#ifndef AMD_AGS_SDK_CFX_API_SAMPLE_WINDOW_H_
+#define AMD_AGS_SDK_CFX_API_SAMPLE_WINDOW_H_
 
 #include <string>
 #include <Windows.h>

eyefinity_sample/build/EyefinitySample_2015.vcxproj

@@ -16,7 +16,7 @@
     <Keyword>Win32Proj</Keyword>
     <RootNamespace>EyefinitySample</RootNamespace>
     <ProjectName>EyefinitySample</ProjectName>
-    <WindowsTargetPlatformVersion>10.0.10240.0</WindowsTargetPlatformVersion>
+    <WindowsTargetPlatformVersion>8.1</WindowsTargetPlatformVersion>
   </PropertyGroup>
   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'" Label="Configuration">

eyefinity_sample/dxut/Core/DXUT_2015.vcxproj

@@ -16,7 +16,7 @@
     <Keyword>Win32Proj</Keyword>
     <RootNamespace>DXUT</RootNamespace>
     <ProjectName>DXUT</ProjectName>
-    <WindowsTargetPlatformVersion>10.0.10240.0</WindowsTargetPlatformVersion>
+    <WindowsTargetPlatformVersion>8.1</WindowsTargetPlatformVersion>
   </PropertyGroup>
   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'" Label="Configuration">