Enable Performance Counters for OCL and L0.

Change-Id: I1920b9d406c092fbc26fc6ca27766db297a1958b

third_party/metrics_discovery/.revision

@@ -0,0 +1 @@
+0928b82f6242217637c3a89d01eb630c55a52ce7

third_party/metrics_discovery/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019, Intel Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+IN THE SOFTWARE.

third_party/metrics_discovery/README.md

@@ -0,0 +1,68 @@
+# Intel(R) Metrics Discovery Application Programming Interface
+
+## Introduction
+
+This software is a user mode library that provides access to GPU performance data.
+
+The library has OS abstraction layer that allows for interoperability in different environments.
+
+## License
+
+Intel(R) Metrics Discovery Application Programming Interface is distributed under the MIT License.
+
+You may obtain a copy of the License at:
+https://opensource.org/licenses/MIT
+
+## Supported Platforms
+
+- Intel(R) Processors with Gen11 graphics devices (formerly Ice Lake, Elkhart Lake),
+- Intel(R) Processors with Gen9 graphics devices (formerly Skylake, Kaby Lake, Apollo Lake/Broxton, Gemini Lake, Coffee Lake),
+- Intel(R) Processors with Gen8 graphics devices (formerly Broadwell),
+- Intel(R) Processors with Gen7.5 graphics devices (formerly Haswell).
+
+## Supported Operating Systems
+
+Intel(R) Metrics Discovery Application Programming Interface is supported on Linux family operating systems with minimum kernel version 4.14.
+Event based measurements require minimum Mesa version 18.2.
+
+### Detailed minimum version requirements
+
+| Platform | Code Name | Minimum Linux Kernel Version | Minimum Mesa Version |
+|--|--|--|--|
+| Gen11 | Elkhart Lake | 5.3 | 19.1 |
+| Gen11 | Ice Lake | 4.18 | 19.1 |
+| Gen9, Gen8 | * | 4.14 | 18.2 |
+| Gen7.5 | Haswell | 4.17 | 18.2 |
+
+## Build and Install
+
+1\. Download sources.
+
+2\. Run CMake generation:
+
+```shell
+cmake .
+```
+
+3\. Build:
+
+```shell
+make -j$(nproc)
+```
+
+4\. Built library will be here (for 64-bit Linux):
+
+```shell
+(project_root)/dump/linux64/release/md/libmd.so
+```
+
+5\. Install:
+
+```shell
+sudo make install
+```
+
+*Note: To clear CMake params remove CMakeCache.txt, then regenerate.*
+
+##
+___(*) Other names and brands my be claimed as property of others.___

third_party/metrics_library/.revision

@@ -0,0 +1 @@
+608dcb5b626317e1e7550eedc84ff6e542a3b31b

third_party/metrics_library/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020, Intel Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+IN THE SOFTWARE.

third_party/metrics_library/README.md

@@ -0,0 +1,63 @@
+# Intel(R) Metrics Library for MDAPI
+
+## Introduction
+
+This software is a user mode driver helper library that provides access to GPU performance counters.
+
+## License
+
+Intel(R) Metrics Library for MDAPI is distributed under the MIT License.
+
+You may obtain a copy of the License at:
+https://opensource.org/licenses/MIT
+
+## Supported Platforms
+
+- Intel(R) Processors with Gen12 graphics devices
+- Intel(R) Processors with Gen11 graphics devices
+- Intel(R) Processors with Gen9 graphics devices
+
+## Supported Operating Systems
+
+Intel(R) Metrics Library for MDAPI is supported on Linux family operating systems with minimum kernel version 4.14.
+
+## Build and Install
+Not a stand alone software component. Serves as a helper library for particular Intel drivers.
+There is no need to build the library as long as it is an integrated part of those Intel drivers.
+
+1\. Download sources.
+
+2\. Run CMake generation:
+
+```shell
+cmake .
+```
+
+3\. Build:
+
+```shell
+make -j$(nproc)
+```
+
+4\. Built library will be here (for 64-bit Linux):
+
+```shell
+(project_root)/dump/linux64/metrics_library/libigdml64.so
+```
+
+5\. To prepare an installation package:
+
+```shell
+make package
+```
+
+6\. Install:
+
+```shell
+sudo dpkg -i intel-metrics-library*.deb
+```
+
+*Note: To clear CMake parameters remove CMakeCache.txt, then regenerate.*
+
+##
+___(*) Other names and brands my be claimed as property of others.___

third_party/metrics_library/metrics_library_api_1_0.h

@@ -0,0 +1,653 @@
+/******************************************************************************\
+
+    Copyright © 2020, Intel Corporation
+
+    Permission is hereby granted, free of charge, to any person obtaining a
+    copy of this software and associated documentation files (the "Software"),
+    to deal in the Software without restriction, including without limitation
+    the rights to use, copy, modify, merge, publish, distribute, sublicense,
+    and/or sell copies of the Software, and to permit persons to whom the
+    Software is furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included
+    in all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+    THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+    IN THE SOFTWARE.
+
+    File Name:  metrics_library_api_1_0.h
+
+    Abstract:   Interface for Metrics Library umd dll.
+
+    Notes:
+
+\******************************************************************************/
+#pragma once
+#include <stdint.h>
+
+#ifdef _MSC_VER
+    #define ML_STDCALL __stdcall
+#else
+    #define ML_STDCALL
+#endif
+
+namespace MetricsLibraryApi
+{
+//////////////////////////////////////////////////////////////////////////
+/// @brief Metrics Library handles.
+//////////////////////////////////////////////////////////////////////////
+#define METRICS_LIBRARY_HANDLE(Object)  typedef struct Object##Handle_1_0                                       \
+                                        {                                                                       \
+                                            void* data;                                                         \
+                                            Object##Handle_1_0( void )          { data = nullptr; }             \
+                                            Object##Handle_1_0( void* handle )  { data = handle; }              \
+                                            bool IsValid( void ) const      { return data != nullptr; }         \
+                                        } Object##Handle_1_0;
+
+METRICS_LIBRARY_HANDLE( Client )
+METRICS_LIBRARY_HANDLE( ClientMemory )
+METRICS_LIBRARY_HANDLE( Configuration )
+METRICS_LIBRARY_HANDLE( Context )
+METRICS_LIBRARY_HANDLE( Marker )
+METRICS_LIBRARY_HANDLE( Override )
+METRICS_LIBRARY_HANDLE( Query )
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Client api types.
+//////////////////////////////////////////////////////////////////////////
+enum class ClientApi : uint32_t
+{
+    Unknown = 0,
+    // 1-5 reserved.
+    OpenCL = 6,
+    // 7-8 reserved.
+    OneApi = 9,
+    // 10 reserved.
+    // ...
+    Last
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Client gpu generation types.
+//////////////////////////////////////////////////////////////////////////
+enum class ClientGen : uint32_t
+{
+    Unknown = 0,
+    Gen9,
+    Gen9LP,
+    Gen10,
+    Gen11,
+    Gen11LP,
+    Gen12,
+    // ...
+    Last
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Library object types.
+//////////////////////////////////////////////////////////////////////////
+enum class ObjectType : uint32_t
+{
+    Unknown                         = 0,
+
+    // Context objects:
+    Context                         = 10000,
+
+    // Query objects:
+    QueryHwCounters                 = 20000,
+    QueryPipelineTimestamps         = 20001,
+
+    // Configuration objects:
+    ConfigurationHwCountersOa       = 30000,
+    ConfigurationHwCountersUser,
+
+    // Override objects:
+    OverrideUser                    = 40000,
+    OverrideNullHardware,
+    OverrideFlushCaches,
+    OverridePoshQuery,
+    OverrideDisablePoshPrimitives,
+
+    // Markers:
+    MarkerStreamUser                = 50000,
+    MarkerStreamUserExtended        = 50001,
+
+    // ...
+    Last
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Client options types.
+//////////////////////////////////////////////////////////////////////////
+enum class ClientOptionsType : uint32_t
+{
+    Posh = 0,
+    Ptbr,
+    Compute,
+    // ...
+    Last
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Status code types.
+//////////////////////////////////////////////////////////////////////////
+enum class StatusCode : uint32_t
+{
+    Success = 0,
+    Failed,
+    IncorrectVersion,
+    IncorrectParameter,
+    IncorrectSlot,
+    IncorrectObject,
+    InsufficientSpace,
+    NotInitialized,
+    NotSupported,
+    NotImplemented,
+    NullPointer,
+    OutOfMemory,
+    UnknownGen,
+    TbsUnableToEnable,
+    TbsUnableToRead,
+    ReportNotReady,
+    ReportLost,
+    ReportInconsistent,
+    // ...
+    Last
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Value types.
+//////////////////////////////////////////////////////////////////////////
+enum class ValueType : uint8_t
+{
+    Uint8 = 0,
+    Int8,
+    Uint16,
+    Int16,
+    Uint32,
+    Int32,
+    Uint64,
+    Int64,
+    Float,
+    Double,
+    Bool,
+    String,
+    // ...
+    Last
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Gpu configuration activation types.
+//////////////////////////////////////////////////////////////////////////
+enum class GpuConfigurationActivationType : uint32_t
+{
+    EscapeCode = 0,
+    Tbs,
+    // ...
+    Last
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Gpu command buffer types.
+//////////////////////////////////////////////////////////////////////////
+enum class GpuCommandBufferType : uint32_t
+{
+    Render = 0,
+    Posh,
+    Tile,
+    Compute,
+    // ...
+    Last
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Memory types.
+//////////////////////////////////////////////////////////////////////////
+enum class MemoryType : uint32_t
+{
+    Query = 0,
+    CommandBuffer,
+    Cpu,
+    // ...
+    Last
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Memory flags.
+//////////////////////////////////////////////////////////////////////////
+enum class MemoryFlags : uint32_t
+{
+    Linear      = 1 << 0,
+    Cachable    = 1 << 1
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Parameter types.
+//////////////////////////////////////////////////////////////////////////
+enum class ParameterType : uint32_t
+{
+    QueryHwCountersReportApiSize = 0,
+    QueryHwCountersReportGpuSize,
+    QueryPipelineTimestampsReportApiSize,
+    QueryPipelineTimestampsReportGpuSize,
+    LibraryBuildNumber,
+    // ...
+    Last
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Client type.
+//////////////////////////////////////////////////////////////////////////
+struct ClientType_1_0
+{
+    ClientApi    Api;
+    ClientGen    Gen;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Typed value.
+//////////////////////////////////////////////////////////////////////////
+struct TypedValue_1_0
+{
+    ValueType    Type;
+
+    union
+    {
+        int8_t         ValueInt8;
+        uint8_t        ValueUInt8;
+        int16_t        ValueInt16;
+        uint16_t       ValueUInt16;
+        int32_t        ValueInt32;
+        uint32_t       ValueUInt32;
+        int64_t        ValueInt64;
+        uint64_t       ValueUInt64;
+        float          ValueFloat;
+        bool           ValueBool;
+        const char*    ValueString;
+    };
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Gpu memory data.
+//////////////////////////////////////////////////////////////////////////
+struct GpuMemory_1_0
+{
+    uint64_t                  GpuAddress;      // Virtual gpu address.
+    void*                     CpuAddress;      // Locked cpu address.
+    ClientMemoryHandle_1_0    HandleMemory;    // Driver's handle.
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Query creation data.
+//////////////////////////////////////////////////////////////////////////
+struct QueryCreateData_1_0
+{
+    ContextHandle_1_0    HandleContext;
+    ObjectType           Type;
+    uint32_t             Slots;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Query hw counters command buffer data.
+//////////////////////////////////////////////////////////////////////////
+struct CommandBufferQueryHwCounters_1_0
+{
+    QueryHandle_1_0            Handle;
+    ConfigurationHandle_1_0    HandleUserConfiguration;
+    uint32_t                   Slot;
+    uint64_t                   MarkerUser;
+    uint64_t                   MarkerDriver;
+    uint64_t                   EndTag;
+    bool                       Begin;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Query pipeline timestamps command buffer data.
+//////////////////////////////////////////////////////////////////////////
+struct CommandBufferQueryPipelineTimestamps_1_0
+{
+    QueryHandle_1_0            Handle;
+    uint64_t                   EndTag;
+    bool                       Begin;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Overrides commands data.
+//////////////////////////////////////////////////////////////////////////
+struct CommandBufferOverride_1_0
+{
+    OverrideHandle_1_0    Handle;
+    bool                  Enable;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Marker stream user commands data.
+//////////////////////////////////////////////////////////////////////////
+struct CommandBufferMarkerStreamUser_1_0
+{
+    uint32_t    Reserved : 7;
+    uint32_t    Value    : 25;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Marker stream user extended commands data.
+//////////////////////////////////////////////////////////////////////////
+struct CommandBufferMarkerStreamUserExtended_1_0
+{
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Command buffer data.
+//////////////////////////////////////////////////////////////////////////
+struct CommandBufferData_1_0
+{
+    ContextHandle_1_0       HandleContext;    // Context handle.
+    ObjectType              CommandsType;     // Commands type related to library object.
+    GpuCommandBufferType    Type;             // Gpu command buffer type.
+    GpuMemory_1_0           Allocation;       // Gpu memory allocation.
+    void*                   Data;             // Gpu command buffer data.
+    uint32_t                Size;             // Gpu command buffer size.
+    uint32_t                Offset;           // Gpu command buffer offset from beginning.
+
+    union
+    {
+        CommandBufferQueryHwCounters_1_0             QueryHwCounters;
+        CommandBufferQueryPipelineTimestamps_1_0     QueryPipelineTimestamps;
+        CommandBufferOverride_1_0                    Override;
+        CommandBufferMarkerStreamUser_1_0            MarkerStreamUser;
+        CommandBufferMarkerStreamUserExtended_1_0    MarkerStreamUserExtended;
+    };
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Command buffer size.
+//////////////////////////////////////////////////////////////////////////
+struct CommandBufferSize_1_0
+{
+    uint32_t    GpuMemorySize;
+    uint32_t    GpuMemoryPatchesCount;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Override create data.
+//////////////////////////////////////////////////////////////////////////
+struct OverrideCreateData_1_0
+{
+    ContextHandle_1_0    HandleContext;
+    ObjectType           Type;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Marker creation data.
+//////////////////////////////////////////////////////////////////////////
+struct MarkerCreateData_1_0
+{
+    ContextHandle_1_0    HandleContext;
+    ObjectType           Type;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Configuration creation data.
+//////////////////////////////////////////////////////////////////////////
+struct ConfigurationCreateData_1_0
+{
+    ContextHandle_1_0    HandleContext;
+    ObjectType           Type;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Configuration activate data.
+//////////////////////////////////////////////////////////////////////////
+struct ConfigurationActivateData_1_0
+{
+    GpuConfigurationActivationType    Type;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Get query report.
+//////////////////////////////////////////////////////////////////////////
+struct GetReportQuery_1_0
+{
+    QueryHandle_1_0    Handle;        // Input.
+
+    uint32_t           Slot;          // Input.
+    uint32_t           SlotsCount;    // Input.
+
+    uint32_t           DataSize;      // Input.
+    void*              Data;          // Input / output.
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Get override report.
+//////////////////////////////////////////////////////////////////////////
+struct GetReportOverride_1_0
+{
+    OverrideHandle_1_0    Handle;      // Input.
+
+    uint32_t              DataSize;    // Input.
+    void*                 Data;        // Output.
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Get data.
+//////////////////////////////////////////////////////////////////////////
+struct GetReportData_1_0
+{
+    ObjectType    Type;
+
+    union
+    {
+        GetReportQuery_1_0               Query;
+        GetReportOverride_1_0            Override;
+    };
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Gpu memory allocate data.
+//////////////////////////////////////////////////////////////////////////
+struct GpuMemoryAllocateData_1_0
+{
+    MemoryType     Type;     // Input.
+    MemoryFlags    Flags;    // Input.
+    uint32_t       Size;     // Input.
+    void*          Data;     // Output.
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Cpu memory allocate data.
+//////////////////////////////////////////////////////////////////////////
+struct CpuMemoryAllocateData_1_0
+{
+    uint32_t    Size;    // Input.
+    void*       Data;    // Output.
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Metrics Library functions.
+//////////////////////////////////////////////////////////////////////////
+using GetParameterFunction_1_0            = StatusCode( ML_STDCALL* ) ( const ParameterType parameter, ValueType* type, TypedValue_1_0* value );
+
+using CommandBufferGetFunction_1_0        = StatusCode( ML_STDCALL* ) ( const CommandBufferData_1_0* data );
+using CommandBufferGetSizeFunction_1_0    = StatusCode( ML_STDCALL* ) ( const CommandBufferData_1_0* data, CommandBufferSize_1_0* size );
+
+using QueryCreateFunction_1_0             = StatusCode( ML_STDCALL* ) ( const QueryCreateData_1_0* createData, QueryHandle_1_0* handle );
+using QueryDeleteFunction_1_0             = StatusCode( ML_STDCALL* ) ( const QueryHandle_1_0 handle );
+
+using OverrideCreateFunction_1_0          = StatusCode( ML_STDCALL* ) ( const OverrideCreateData_1_0* createData, OverrideHandle_1_0* handle );
+using OverrideDeleteFunction_1_0          = StatusCode( ML_STDCALL* ) ( const OverrideHandle_1_0 handle );
+
+using MarkerCreateFunction_1_0            = StatusCode( ML_STDCALL* ) ( const MarkerCreateData_1_0* createData, MarkerHandle_1_0* handle );
+using MarkerDeleteFunction_1_0            = StatusCode( ML_STDCALL* ) ( const MarkerHandle_1_0 handle );
+
+using ConfigurationCreateFunction_1_0     = StatusCode( ML_STDCALL* ) ( const ConfigurationCreateData_1_0* createData, ConfigurationHandle_1_0* handle );
+using ConfigurationActivateFunction_1_0   = StatusCode( ML_STDCALL* ) ( const ConfigurationHandle_1_0 handle, const ConfigurationActivateData_1_0* activateData );
+using ConfigurationDeactivateFunction_1_0 = StatusCode( ML_STDCALL* ) ( const ConfigurationHandle_1_0 handle );
+using ConfigurationDeleteFunction_1_0     = StatusCode( ML_STDCALL* ) ( const ConfigurationHandle_1_0 handle );
+
+using GetDataFunction_1_0                 = StatusCode( ML_STDCALL* ) ( GetReportData_1_0* data );
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Metrics Library callbacks.
+//////////////////////////////////////////////////////////////////////////
+using CommandBufferFlushCallback_1_0    = StatusCode ( ML_STDCALL* ) ( const ClientHandle_1_0 handle );
+using CommandBufferHasSpaceCallback_1_0 = StatusCode ( ML_STDCALL* ) ( const ClientHandle_1_0 handle );
+using CommandBufferGetSpaceCallback_1_0 = StatusCode ( ML_STDCALL* ) ( const ClientHandle_1_0 handle );
+
+using GpuMemoryAllocateCallback_1_0     = StatusCode ( ML_STDCALL* ) ( const ClientHandle_1_0 handle, GpuMemoryAllocateData_1_0* allocationData, ClientMemoryHandle_1_0* handleMemory );
+using GpuMemoryPatchCallback_1_0        = StatusCode ( ML_STDCALL* ) ( const ClientHandle_1_0 handle, const ClientMemoryHandle_1_0 handleMemory, const uint64_t allocationOffset, const uint64_t buffer );
+using GpuMemoryReleaseCallback_1_0      = StatusCode ( ML_STDCALL* ) ( const ClientHandle_1_0 handle );
+
+using CpuMemoryAllocateCallback_1_0     = StatusCode ( ML_STDCALL* ) ( const ClientHandle_1_0 handle, CpuMemoryAllocateData_1_0* allocationData, ClientMemoryHandle_1_0* handleMemory );
+using CpuMemoryReleaseCallback_1_0      = StatusCode ( ML_STDCALL* ) ( const ClientHandle_1_0 handle );
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Metrics Library interface.
+//////////////////////////////////////////////////////////////////////////
+struct Interface_1_0
+{
+    GetParameterFunction_1_0               GetParameter;
+
+    CommandBufferGetFunction_1_0           CommandBufferGet;
+    CommandBufferGetSizeFunction_1_0       CommandBufferGetSize;
+
+    QueryCreateFunction_1_0                QueryCreate;
+    QueryDeleteFunction_1_0                QueryDelete;
+
+    OverrideCreateFunction_1_0             OverrideCreate;
+    OverrideDeleteFunction_1_0             OverrideDelete;
+
+    MarkerCreateFunction_1_0               MarkerCreate;
+    MarkerDeleteFunction_1_0               MarkerDelete;
+
+    ConfigurationCreateFunction_1_0        ConfigurationCreate;
+    ConfigurationActivateFunction_1_0      ConfigurationActivate;
+    ConfigurationDeactivateFunction_1_0    ConfigurationDeactivate;
+    ConfigurationDeleteFunction_1_0        ConfigurationDelete;
+
+    GetDataFunction_1_0                    GetData;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Metrics Library interface callbacks.
+//////////////////////////////////////////////////////////////////////////
+struct ClientCallbacks_1_0
+{
+    CommandBufferFlushCallback_1_0       CommandBufferFlush;
+    CommandBufferHasSpaceCallback_1_0    CommandBufferHasSpace;
+    CommandBufferGetSpaceCallback_1_0    CommandBufferGetSpace;
+
+    GpuMemoryAllocateCallback_1_0        GpuMemoryAllocate;
+    GpuMemoryPatchCallback_1_0           GpuMemoryPatch;
+    GpuMemoryReleaseCallback_1_0         GpuMemoryRelease;
+
+    CpuMemoryAllocateCallback_1_0        CpuMemoryAllocate;
+    CpuMemoryReleaseCallback_1_0         CpuMemoryRelease;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Windows client data.
+//////////////////////////////////////////////////////////////////////////
+struct ClientDataWindows_1_0
+{
+    void*    Device;
+    void*    Adapter;
+    void*    Escape;
+    bool     KmdInstrumentationEnabled;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Linux client data.
+//////////////////////////////////////////////////////////////////////////
+struct ClientDataLinux_1_0
+{
+    void*    Reserved;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Client options posh data.
+//////////////////////////////////////////////////////////////////////////
+struct ClientOptionsPoshData_1_0
+{
+    bool    Enabled;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Client options ptbr data.
+//////////////////////////////////////////////////////////////////////////
+struct ClientOptionsPtbrData_1_0
+{
+    bool    Enabled;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Client options compute data.
+//////////////////////////////////////////////////////////////////////////
+struct ClientOptionsComputeData_1_0
+{
+    bool    Asynchronous;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Client options data.
+//////////////////////////////////////////////////////////////////////////
+struct ClientOptionsData_1_0
+{
+    ClientOptionsType    Type;
+
+    union
+    {
+        ClientOptionsPoshData_1_0       Posh;
+        ClientOptionsPtbrData_1_0       Ptbr;
+        ClientOptionsComputeData_1_0    Compute;
+    };
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Client data.
+//////////////////////////////////////////////////////////////////////////
+struct ClientData_1_0
+{
+    ClientHandle_1_0    Handle;
+
+    union
+    {
+        ClientDataWindows_1_0    Windows;
+        ClientDataLinux_1_0      Linux;
+    };
+
+    ClientOptionsData_1_0*    ClientOptions;
+    uint32_t                  ClientOptionsCount;
+};
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Context create data.
+//////////////////////////////////////////////////////////////////////////
+struct ContextCreateData_1_0
+{
+    ClientData_1_0*        ClientData;
+    ClientCallbacks_1_0*   ClientCallbacks;
+    Interface_1_0*         Api;
+};
+
+using ContextCreateFunction_1_0 = StatusCode ( ML_STDCALL* ) ( ClientType_1_0 clientType, ContextCreateData_1_0* createData, ContextHandle_1_0* handle );
+using ContextDeleteFunction_1_0 = StatusCode ( ML_STDCALL* ) ( const ContextHandle_1_0 handle );
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Metrics Library initialize/destroy functions.
+//////////////////////////////////////////////////////////////////////////
+#define METRICS_LIBRARY_CONTEXT_CREATE_1_0 "ContextCreate_1_0"
+#define METRICS_LIBRARY_CONTEXT_DELETE_1_0 "ContextDelete_1_0"
+
+//////////////////////////////////////////////////////////////////////////
+/// @brief Metrics Library current version.
+//////////////////////////////////////////////////////////////////////////
+#define METRICS_LIBRARY_MAJOR_NUMBER 1
+#define METRICS_LIBRARY_MINOR_NUMBER 0
+#define METRICS_LIBRARY_BUILD_NUMBER 1
+
+} // namespace MetricsLibraryApi