xTr1m/bluflame
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
bluflame/ruins64k/tools/NvPerf/include/nvperf_host.h
Frank Tovar 8d0ab5b7cc port from perforce
2026-04-18 22:31:51 +02:00

1185 lines
47 KiB
C
Raw Permalink Blame History

#ifndef NVPERF_HOST_H
#define NVPERF_HOST_H
/*
* Copyright 2014-2021 NVIDIA Corporation. All rights reserved.
*
* NOTICE TO USER:
*
* This source code is subject to NVIDIA ownership rights under U.S. and
* international Copyright laws.
*
* This software and the information contained herein is PROPRIETARY and
* CONFIDENTIAL to NVIDIA and is being provided under the terms and conditions
* of a form of NVIDIA software license agreement.
*
* NVIDIA MAKES NO REPRESENTATION ABOUT THE SUITABILITY OF THIS SOURCE
* CODE FOR ANY PURPOSE. IT IS PROVIDED "AS IS" WITHOUT EXPRESS OR
* IMPLIED WARRANTY OF ANY KIND. NVIDIA DISCLAIMS ALL WARRANTIES WITH
* REGARD TO THIS SOURCE CODE, INCLUDING ALL IMPLIED WARRANTIES OF
* MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.
* IN NO EVENT SHALL NVIDIA BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL,
* OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
* OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
* OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE
* OR PERFORMANCE OF THIS SOURCE CODE.
*
* U.S. Government End Users. This source code is a "commercial item" as
* that term is defined at 48 C.F.R. 2.101 (OCT 1995), consisting of
* "commercial computer software" and "commercial computer software
* documentation" as such terms are used in 48 C.F.R. 12.212 (SEPT 1995)
* and is provided to the U.S. Government only as a commercial end item.
* Consistent with 48 C.F.R.12.212 and 48 C.F.R. 227.7202-1 through
* 227.7202-4 (JUNE 1995), all U.S. Government End Users acquire the
* source code with only those rights set forth herein.
*
* Any use of this source code in individual and commercial software must
* include, in the user documentation and internal comments to the code,
* the above Disclaimer and U.S. Government End Users Notice.
*/
#define NVAPI _cdecl
#include <stddef.h>
#include <stdint.h>
#if defined(__GNUC__) && defined(NVPA_SHARED_LIB)
#pragma GCC visibility push(default)
#if !defined(NVPW_LOCAL)
#define NVPW_LOCAL __attribute__ ((visibility ("hidden")))
#endif
#else
#if !defined(NVPW_LOCAL)
#define NVPW_LOCAL
#endif
#endif
#ifdef __cplusplus
extern "C" {
#endif
/**
* @file nvperf_host.h
*/
/***************************************************************************//**
* @name Common Types
* @{
*/
#ifndef NVPERF_NVPA_STATUS_DEFINED
#define NVPERF_NVPA_STATUS_DEFINED
/// Error codes.
typedef enum NVPA_Status
{
/// Success
NVPA_STATUS_SUCCESS = 0,
/// Generic error.
NVPA_STATUS_ERROR = 1,
/// Internal error. Please file a bug!
NVPA_STATUS_INTERNAL_ERROR = 2,
/// NVPW_InitializeTarget() has not been called yet.
NVPA_STATUS_NOT_INITIALIZED = 3,
/// The NvPerf DLL/DSO could not be loaded during NVPW_Initialize*.
NVPA_STATUS_NOT_LOADED = 4,
/// The function was not found in this version of the NvPerf DLL/DSO.
NVPA_STATUS_FUNCTION_NOT_FOUND = 5,
/// The request was intentionally not supported.
NVPA_STATUS_NOT_SUPPORTED = 6,
/// The request was not implemented by this version.
NVPA_STATUS_NOT_IMPLEMENTED = 7,
/// Invalid argument.
NVPA_STATUS_INVALID_ARGUMENT = 8,
/// UNUSED
NVPA_STATUS_INVALID_METRIC_ID = 9,
/// No driver has been loaded via NVPW_*_LoadDriver().
NVPA_STATUS_DRIVER_NOT_LOADED = 10,
/// Failed memory allocation.
NVPA_STATUS_OUT_OF_MEMORY = 11,
/// UNUSED
NVPA_STATUS_INVALID_THREAD_STATE = 12,
/// UNUSED
NVPA_STATUS_FAILED_CONTEXT_ALLOC = 13,
/// The specified GPU is not supported.
NVPA_STATUS_UNSUPPORTED_GPU = 14,
/// The installed NVIDIA driver is too old.
NVPA_STATUS_INSUFFICIENT_DRIVER_VERSION = 15,
/// UNUSED
NVPA_STATUS_OBJECT_NOT_REGISTERED = 16,
/// Profiling permission not granted; see https://developer.nvidia.com/nvidia-development-tools-solutions-
/// ERR_NVGPUCTRPERM-permission-issue-performance-counters
NVPA_STATUS_INSUFFICIENT_PRIVILEGE = 17,
/// UNUSED
NVPA_STATUS_INVALID_CONTEXT_STATE = 18,
/// UNUSED
NVPA_STATUS_INVALID_OBJECT_STATE = 19,
/// The request could not be fulfilled because a system resource is already in use.
NVPA_STATUS_RESOURCE_UNAVAILABLE = 20,
/// UNUSED
NVPA_STATUS_DRIVER_LOADED_TOO_LATE = 21,
/// The provided buffer is not large enough.
NVPA_STATUS_INSUFFICIENT_SPACE = 22,
/// UNUSED
NVPA_STATUS_OBJECT_MISMATCH = 23,
/// Virtualized GPU (vGPU) is not supported.
NVPA_STATUS_VIRTUALIZED_DEVICE_NOT_SUPPORTED = 24,
/// Profiling permission on a vGPU was not granted.
NVPA_STATUS_PROFILING_NOT_ALLOWED = 25,
NVPA_STATUS__COUNT
} NVPA_Status;
#endif // NVPERF_NVPA_STATUS_DEFINED
#ifndef NVPERF_NVPA_ACTIVITY_KIND_DEFINED
#define NVPERF_NVPA_ACTIVITY_KIND_DEFINED
/// The configuration's activity-kind dictates which types of data may be collected.
typedef enum NVPA_ActivityKind
{
/// Invalid value.
NVPA_ACTIVITY_KIND_INVALID = 0,
/// A workload-centric activity for serialized and pipelined collection.
///
/// Profiler is capable of collecting both serialized and pipelined metrics. The library introduces any
/// synchronization required to collect serialized metrics.
NVPA_ACTIVITY_KIND_PROFILER,
/// A realtime activity for sampling counters from the CPU or GPU.
NVPA_ACTIVITY_KIND_REALTIME_SAMPLED,
/// A realtime activity for profiling counters from the CPU or GPU without CPU/GPU synchronizations.
NVPA_ACTIVITY_KIND_REALTIME_PROFILER,
NVPA_ACTIVITY_KIND__COUNT
} NVPA_ActivityKind;
#endif // NVPERF_NVPA_ACTIVITY_KIND_DEFINED
#ifndef NVPERF_NVPA_BOOL_DEFINED
#define NVPERF_NVPA_BOOL_DEFINED
/// The type used for boolean values.
typedef uint8_t NVPA_Bool;
#endif // NVPERF_NVPA_BOOL_DEFINED
#ifndef NVPA_STRUCT_SIZE
#define NVPA_STRUCT_SIZE(type_, lastfield_) (offsetof(type_, lastfield_) + sizeof(((type_*)0)->lastfield_))
#endif // NVPA_STRUCT_SIZE
#ifndef NVPERF_NVPA_GETPROCADDRESS_DEFINED
#define NVPERF_NVPA_GETPROCADDRESS_DEFINED
typedef NVPA_Status (*NVPA_GenericFn)(void);
///
/// Gets the address of an NvPerf API function.
///
/// \return A function pointer to the function, or NULL if the function is not available.
///
/// \param pFunctionName [in] Name of the function to retrieve.
NVPA_GenericFn NVAPI NVPA_GetProcAddress(const char* pFunctionName);
#endif
#ifndef NVPERF_NVPW_SETLIBRARYLOADPATHS_DEFINED
#define NVPERF_NVPW_SETLIBRARYLOADPATHS_DEFINED
typedef struct NVPW_SetLibraryLoadPaths_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [in] number of paths in ppPaths
size_t numPaths;
/// [in] array of null-terminated paths
const char** ppPaths;
} NVPW_SetLibraryLoadPaths_Params;
#define NVPW_SetLibraryLoadPaths_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_SetLibraryLoadPaths_Params, ppPaths)
/// Sets library search path for \ref NVPW_InitializeHost() and \ref NVPW_InitializeTarget().
/// \ref NVPW_InitializeHost() and \ref NVPW_InitializeTarget load the NvPerf DLL/DSO. This function sets
/// ordered paths that will be searched with the LoadLibrary() or dlopen() call.
/// If load paths are set by this function, the default set of load paths
/// will not be attempted.
/// Each path must point at a directory (not a file name).
/// This function is not thread-safe.
/// Example Usage:
/// \code
/// const char* paths[] = {
/// "path1", "path2", etc
/// };
/// NVPW_SetLibraryLoadPaths_Params params{NVPW_SetLibraryLoadPaths_Params_STRUCT_SIZE};
/// params.numPaths = sizeof(paths)/sizeof(paths[0]);
/// params.ppPaths = paths;
/// NVPW_SetLibraryLoadPaths(&params);
/// NVPW_InitializeHost();
/// params.numPaths = 0;
/// params.ppPaths = NULL;
/// NVPW_SetLibraryLoadPaths(&params);
/// \endcode
NVPA_Status NVAPI NVPW_SetLibraryLoadPaths(NVPW_SetLibraryLoadPaths_Params* pParams);
typedef struct NVPW_SetLibraryLoadPathsW_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [in] number of paths in ppwPaths
size_t numPaths;
/// [in] array of null-terminated paths
const wchar_t** ppwPaths;
} NVPW_SetLibraryLoadPathsW_Params;
#define NVPW_SetLibraryLoadPathsW_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_SetLibraryLoadPathsW_Params, ppwPaths)
/// Sets library search path for \ref NVPW_InitializeHost() and \ref NVPW_InitializeTarget().
/// \ref NVPW_InitializeHost() and \ref NVPW_InitializeTarget load the NvPerf DLL/DSO. This function sets
/// ordered paths that will be searched with the LoadLibrary() or dlopen() call.
/// If load paths are set by this function, the default set of load paths
/// will not be attempted.
/// Each path must point at a directory (not a file name).
/// This function is not thread-safe.
/// Example Usage:
/// \code
/// const wchar_t* wpaths[] = {
/// L"path1", L"path2", etc
/// };
/// NVPW_SetLibraryLoadPathsW_Params params{NVPW_SetLibraryLoadPathsW_Params_STRUCT_SIZE};
/// params.numPaths = sizeof(wpaths)/sizeof(wpaths[0]);
/// params.ppwPaths = wpaths;
/// NVPW_SetLibraryLoadPathsW(&params);
/// NVPW_InitializeHost();
/// params.numPaths = 0;
/// params.ppwPaths = NULL;
/// NVPW_SetLibraryLoadPathsW(&params);
/// \endcode
NVPA_Status NVAPI NVPW_SetLibraryLoadPathsW(NVPW_SetLibraryLoadPathsW_Params* pParams);
#endif
/**
* @}
******************************************************************************/
// Guard against multiple definition of NvPerf host types
#ifndef NVPERF_HOST_API_DEFINED
#define NVPERF_HOST_API_DEFINED
/***************************************************************************//**
* @name Host Configuration
* @{
*/
typedef struct NVPW_InitializeHost_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
} NVPW_InitializeHost_Params;
#define NVPW_InitializeHost_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_InitializeHost_Params, pPriv)
/// Load the host library.
NVPA_Status NVAPI NVPW_InitializeHost(NVPW_InitializeHost_Params* pParams);
typedef struct NVPW_CounterData_CalculateCounterDataImageCopySize_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// The CounterDataPrefix generated from e.g. nvperf2 initdata or
/// NVPW_CounterDataBuilder_GetCounterDataPrefix(). Must be align(8).
const uint8_t* pCounterDataPrefix;
size_t counterDataPrefixSize;
/// max number of ranges that can be profiled
uint32_t maxNumRanges;
/// max number of RangeTree nodes; must be >= maxNumRanges
uint32_t maxNumRangeTreeNodes;
/// max string length of each RangeName, including the trailing NUL character
uint32_t maxRangeNameLength;
const uint8_t* pCounterDataSrc;
/// [out] required size of the copy buffer
size_t copyDataImageCounterSize;
} NVPW_CounterData_CalculateCounterDataImageCopySize_Params;
#define NVPW_CounterData_CalculateCounterDataImageCopySize_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_CounterData_CalculateCounterDataImageCopySize_Params, copyDataImageCounterSize)
NVPA_Status NVAPI NVPW_CounterData_CalculateCounterDataImageCopySize(NVPW_CounterData_CalculateCounterDataImageCopySize_Params* pParams);
typedef struct NVPW_CounterData_InitializeCounterDataImageCopy_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// The CounterDataPrefix generated from e.g. nvperf2 initdata or
/// NVPW_CounterDataBuilder_GetCounterDataPrefix(). Must be align(8).
const uint8_t* pCounterDataPrefix;
size_t counterDataPrefixSize;
/// max number of ranges that can be profiled
uint32_t maxNumRanges;
/// max number of RangeTree nodes; must be >= maxNumRanges
uint32_t maxNumRangeTreeNodes;
/// max string length of each RangeName, including the trailing NUL character
uint32_t maxRangeNameLength;
const uint8_t* pCounterDataSrc;
uint8_t* pCounterDataDst;
} NVPW_CounterData_InitializeCounterDataImageCopy_Params;
#define NVPW_CounterData_InitializeCounterDataImageCopy_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_CounterData_InitializeCounterDataImageCopy_Params, pCounterDataDst)
NVPA_Status NVAPI NVPW_CounterData_InitializeCounterDataImageCopy(NVPW_CounterData_InitializeCounterDataImageCopy_Params* pParams);
typedef struct NVPA_CounterDataCombiner NVPA_CounterDataCombiner;
typedef struct NVPW_CounterDataCombiner_Create_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// The destination counter data into which the source datas will be combined
uint8_t* pCounterDataDst;
/// [out] The created counter data combiner
NVPA_CounterDataCombiner* pCounterDataCombiner;
} NVPW_CounterDataCombiner_Create_Params;
#define NVPW_CounterDataCombiner_Create_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_CounterDataCombiner_Create_Params, pCounterDataCombiner)
NVPA_Status NVAPI NVPW_CounterDataCombiner_Create(NVPW_CounterDataCombiner_Create_Params* pParams);
typedef struct NVPW_CounterDataCombiner_Destroy_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
NVPA_CounterDataCombiner* pCounterDataCombiner;
} NVPW_CounterDataCombiner_Destroy_Params;
#define NVPW_CounterDataCombiner_Destroy_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_CounterDataCombiner_Destroy_Params, pCounterDataCombiner)
NVPA_Status NVAPI NVPW_CounterDataCombiner_Destroy(NVPW_CounterDataCombiner_Destroy_Params* pParams);
typedef struct NVPW_CounterDataCombiner_CreateRange_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
NVPA_CounterDataCombiner* pCounterDataCombiner;
size_t numDescriptions;
const char* const* ppDescriptions;
/// [out]
size_t rangeIndexDst;
} NVPW_CounterDataCombiner_CreateRange_Params;
#define NVPW_CounterDataCombiner_CreateRange_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_CounterDataCombiner_CreateRange_Params, rangeIndexDst)
NVPA_Status NVAPI NVPW_CounterDataCombiner_CreateRange(NVPW_CounterDataCombiner_CreateRange_Params* pParams);
typedef struct NVPW_CounterDataCombiner_AccumulateIntoRange_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
NVPA_CounterDataCombiner* pCounterDataCombiner;
size_t rangeIndexDst;
uint32_t dstMultiplier;
const uint8_t* pCounterDataSrc;
size_t rangeIndexSrc;
uint32_t srcMultiplier;
} NVPW_CounterDataCombiner_AccumulateIntoRange_Params;
#define NVPW_CounterDataCombiner_AccumulateIntoRange_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_CounterDataCombiner_AccumulateIntoRange_Params, srcMultiplier)
NVPA_Status NVAPI NVPW_CounterDataCombiner_AccumulateIntoRange(NVPW_CounterDataCombiner_AccumulateIntoRange_Params* pParams);
typedef struct NVPW_CounterDataCombiner_SumIntoRange_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
NVPA_CounterDataCombiner* pCounterDataCombiner;
size_t rangeIndexDst;
const uint8_t* pCounterDataSrc;
size_t rangeIndexSrc;
} NVPW_CounterDataCombiner_SumIntoRange_Params;
#define NVPW_CounterDataCombiner_SumIntoRange_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_CounterDataCombiner_SumIntoRange_Params, rangeIndexSrc)
NVPA_Status NVAPI NVPW_CounterDataCombiner_SumIntoRange(NVPW_CounterDataCombiner_SumIntoRange_Params* pParams);
typedef struct NVPW_CounterDataCombiner_WeightedSumIntoRange_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
NVPA_CounterDataCombiner* pCounterDataCombiner;
size_t rangeIndexDst;
double dstMultiplier;
const uint8_t* pCounterDataSrc;
size_t rangeIndexSrc;
double srcMultiplier;
} NVPW_CounterDataCombiner_WeightedSumIntoRange_Params;
#define NVPW_CounterDataCombiner_WeightedSumIntoRange_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_CounterDataCombiner_WeightedSumIntoRange_Params, srcMultiplier)
NVPA_Status NVAPI NVPW_CounterDataCombiner_WeightedSumIntoRange(NVPW_CounterDataCombiner_WeightedSumIntoRange_Params* pParams);
/**
* @}
******************************************************************************/
/***************************************************************************//**
* @name Metrics Configuration
* @{
*/
typedef struct NVPA_RawMetricsConfig NVPA_RawMetricsConfig;
typedef struct NVPA_RawMetricRequest
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// in
const char* pMetricName;
/// in
NVPA_Bool isolated;
/// in; ignored by AddMetric but observed by CounterData initialization
NVPA_Bool keepInstances;
} NVPA_RawMetricRequest;
#define NVPA_RAW_METRIC_REQUEST_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPA_RawMetricRequest, keepInstances)
typedef struct NVPW_GetSupportedChipNames_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [out]
const char* const* ppChipNames;
/// [out]
size_t numChipNames;
} NVPW_GetSupportedChipNames_Params;
#define NVPW_GetSupportedChipNames_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_GetSupportedChipNames_Params, numChipNames)
NVPA_Status NVAPI NVPW_GetSupportedChipNames(NVPW_GetSupportedChipNames_Params* pParams);
typedef struct NVPW_RawMetricsConfig_Destroy_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
NVPA_RawMetricsConfig* pRawMetricsConfig;
} NVPW_RawMetricsConfig_Destroy_Params;
#define NVPW_RawMetricsConfig_Destroy_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_RawMetricsConfig_Destroy_Params, pRawMetricsConfig)
NVPA_Status NVAPI NVPW_RawMetricsConfig_Destroy(NVPW_RawMetricsConfig_Destroy_Params* pParams);
typedef struct NVPW_RawMetricsConfig_SetCounterAvailability_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
NVPA_RawMetricsConfig* pRawMetricsConfig;
/// [in] buffer with counter availability image
const uint8_t* pCounterAvailabilityImage;
} NVPW_RawMetricsConfig_SetCounterAvailability_Params;
#define NVPW_RawMetricsConfig_SetCounterAvailability_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_RawMetricsConfig_SetCounterAvailability_Params, pCounterAvailabilityImage)
NVPA_Status NVAPI NVPW_RawMetricsConfig_SetCounterAvailability(NVPW_RawMetricsConfig_SetCounterAvailability_Params* pParams);
typedef struct NVPW_RawMetricsConfig_BeginPassGroup_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
NVPA_RawMetricsConfig* pRawMetricsConfig;
size_t maxPassCount;
} NVPW_RawMetricsConfig_BeginPassGroup_Params;
#define NVPW_RawMetricsConfig_BeginPassGroup_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_RawMetricsConfig_BeginPassGroup_Params, maxPassCount)
NVPA_Status NVAPI NVPW_RawMetricsConfig_BeginPassGroup(NVPW_RawMetricsConfig_BeginPassGroup_Params* pParams);
typedef struct NVPW_RawMetricsConfig_EndPassGroup_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
NVPA_RawMetricsConfig* pRawMetricsConfig;
} NVPW_RawMetricsConfig_EndPassGroup_Params;
#define NVPW_RawMetricsConfig_EndPassGroup_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_RawMetricsConfig_EndPassGroup_Params, pRawMetricsConfig)
NVPA_Status NVAPI NVPW_RawMetricsConfig_EndPassGroup(NVPW_RawMetricsConfig_EndPassGroup_Params* pParams);
typedef struct NVPW_RawMetricsConfig_GetNumMetrics_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
const NVPA_RawMetricsConfig* pRawMetricsConfig;
/// [out]
size_t numMetrics;
} NVPW_RawMetricsConfig_GetNumMetrics_Params;
#define NVPW_RawMetricsConfig_GetNumMetrics_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_RawMetricsConfig_GetNumMetrics_Params, numMetrics)
NVPA_Status NVAPI NVPW_RawMetricsConfig_GetNumMetrics(NVPW_RawMetricsConfig_GetNumMetrics_Params* pParams);
typedef struct NVPW_RawMetricsConfig_GetMetricProperties_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
const NVPA_RawMetricsConfig* pRawMetricsConfig;
size_t metricIndex;
/// [out]
const char* pMetricName;
/// [out]
NVPA_Bool supportsPipelined;
/// [out]
NVPA_Bool supportsIsolated;
} NVPW_RawMetricsConfig_GetMetricProperties_Params;
#define NVPW_RawMetricsConfig_GetMetricProperties_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_RawMetricsConfig_GetMetricProperties_Params, supportsIsolated)
NVPA_Status NVAPI NVPW_RawMetricsConfig_GetMetricProperties(NVPW_RawMetricsConfig_GetMetricProperties_Params* pParams);
typedef struct NVPW_RawMetricsConfig_AddMetrics_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
NVPA_RawMetricsConfig* pRawMetricsConfig;
const NVPA_RawMetricRequest* pRawMetricRequests;
size_t numMetricRequests;
} NVPW_RawMetricsConfig_AddMetrics_Params;
#define NVPW_RawMetricsConfig_AddMetrics_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_RawMetricsConfig_AddMetrics_Params, numMetricRequests)
NVPA_Status NVAPI NVPW_RawMetricsConfig_AddMetrics(NVPW_RawMetricsConfig_AddMetrics_Params* pParams);
typedef struct NVPW_RawMetricsConfig_IsAddMetricsPossible_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
const NVPA_RawMetricsConfig* pRawMetricsConfig;
const NVPA_RawMetricRequest* pRawMetricRequests;
size_t numMetricRequests;
/// [out]
NVPA_Bool isPossible;
} NVPW_RawMetricsConfig_IsAddMetricsPossible_Params;
#define NVPW_RawMetricsConfig_IsAddMetricsPossible_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_RawMetricsConfig_IsAddMetricsPossible_Params, isPossible)
NVPA_Status NVAPI NVPW_RawMetricsConfig_IsAddMetricsPossible(NVPW_RawMetricsConfig_IsAddMetricsPossible_Params* pParams);
typedef struct NVPW_RawMetricsConfig_GenerateConfigImage_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
NVPA_RawMetricsConfig* pRawMetricsConfig;
/// [in] If true, all existing pass groups may be merged to reduce number of passes.
/// If merge was successful, distribution of counters in passes may be updated as a side-effect. The effects
/// will be persistent in pRawMetricsConfig.
NVPA_Bool mergeAllPassGroups;
} NVPW_RawMetricsConfig_GenerateConfigImage_Params;
#define NVPW_RawMetricsConfig_GenerateConfigImage_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_RawMetricsConfig_GenerateConfigImage_Params, mergeAllPassGroups)
/// This API may fail if called inside a pass group with `mergeAllPassGroups` = true.
NVPA_Status NVAPI NVPW_RawMetricsConfig_GenerateConfigImage(NVPW_RawMetricsConfig_GenerateConfigImage_Params* pParams);
typedef struct NVPW_RawMetricsConfig_GetConfigImage_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
const NVPA_RawMetricsConfig* pRawMetricsConfig;
/// [in] Number of bytes allocated for pBuffer
size_t bytesAllocated;
/// [out] [optional] Buffer receiving the config image
uint8_t* pBuffer;
/// [out] Count of bytes that would be copied into pBuffer
size_t bytesCopied;
} NVPW_RawMetricsConfig_GetConfigImage_Params;
#define NVPW_RawMetricsConfig_GetConfigImage_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_RawMetricsConfig_GetConfigImage_Params, bytesCopied)
NVPA_Status NVAPI NVPW_RawMetricsConfig_GetConfigImage(NVPW_RawMetricsConfig_GetConfigImage_Params* pParams);
typedef struct NVPW_RawMetricsConfig_GetNumPasses_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
const NVPA_RawMetricsConfig* pRawMetricsConfig;
/// [out]
size_t numPipelinedPasses;
/// [out]
size_t numIsolatedPasses;
} NVPW_RawMetricsConfig_GetNumPasses_Params;
#define NVPW_RawMetricsConfig_GetNumPasses_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_RawMetricsConfig_GetNumPasses_Params, numIsolatedPasses)
/// Total num passes = numPipelinedPasses + numIsolatedPasses * numNestingLevels
NVPA_Status NVAPI NVPW_RawMetricsConfig_GetNumPasses(NVPW_RawMetricsConfig_GetNumPasses_Params* pParams);
/**
* @}
******************************************************************************/
/***************************************************************************//**
* @name CounterData Creation
* @{
*/
typedef struct NVPA_CounterDataBuilder NVPA_CounterDataBuilder;
typedef struct NVPW_CounterDataBuilder_Create_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [out]
NVPA_CounterDataBuilder* pCounterDataBuilder;
const char* pChipName;
} NVPW_CounterDataBuilder_Create_Params;
#define NVPW_CounterDataBuilder_Create_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_CounterDataBuilder_Create_Params, pChipName)
NVPA_Status NVAPI NVPW_CounterDataBuilder_Create(NVPW_CounterDataBuilder_Create_Params* pParams);
typedef struct NVPW_CounterDataBuilder_Destroy_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
NVPA_CounterDataBuilder* pCounterDataBuilder;
} NVPW_CounterDataBuilder_Destroy_Params;
#define NVPW_CounterDataBuilder_Destroy_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_CounterDataBuilder_Destroy_Params, pCounterDataBuilder)
NVPA_Status NVAPI NVPW_CounterDataBuilder_Destroy(NVPW_CounterDataBuilder_Destroy_Params* pParams);
typedef struct NVPW_CounterDataBuilder_AddMetrics_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
NVPA_CounterDataBuilder* pCounterDataBuilder;
const NVPA_RawMetricRequest* pRawMetricRequests;
size_t numMetricRequests;
} NVPW_CounterDataBuilder_AddMetrics_Params;
#define NVPW_CounterDataBuilder_AddMetrics_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_CounterDataBuilder_AddMetrics_Params, numMetricRequests)
NVPA_Status NVAPI NVPW_CounterDataBuilder_AddMetrics(NVPW_CounterDataBuilder_AddMetrics_Params* pParams);
typedef struct NVPW_CounterDataBuilder_GetCounterDataPrefix_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
NVPA_CounterDataBuilder* pCounterDataBuilder;
/// [in] Number of bytes allocated for pBuffer
size_t bytesAllocated;
/// [out] [optional] Buffer receiving the counter data prefix
uint8_t* pBuffer;
/// [out] Count of bytes that would be copied to pBuffer
size_t bytesCopied;
} NVPW_CounterDataBuilder_GetCounterDataPrefix_Params;
#define NVPW_CounterDataBuilder_GetCounterDataPrefix_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_CounterDataBuilder_GetCounterDataPrefix_Params, bytesCopied)
NVPA_Status NVAPI NVPW_CounterDataBuilder_GetCounterDataPrefix(NVPW_CounterDataBuilder_GetCounterDataPrefix_Params* pParams);
/**
* @}
******************************************************************************/
/***************************************************************************//**
* @name Metrics Evaluator
* @{
*/
typedef struct NVPW_MetricsEvaluator NVPW_MetricsEvaluator;
#ifndef NVPW_DIM_UNIT_DEFINED
#define NVPW_DIM_UNIT_DEFINED
typedef enum NVPW_DimUnitName
{
NVPW_DIM_UNIT_INVALID = 3518299157,
NVPW_DIM_UNIT_UNITLESS = 2126137902,
NVPW_DIM_UNIT_ATTRIBUTES = 3776338729,
NVPW_DIM_UNIT_BYTES = 3797850191,
NVPW_DIM_UNIT_CTAS = 1960564139,
NVPW_DIM_UNIT_DRAM_CYCLES = 2650981327,
NVPW_DIM_UNIT_FBP_CYCLES = 1785238957,
NVPW_DIM_UNIT_FE_OPS = 2919159083,
NVPW_DIM_UNIT_GPC_CYCLES = 1222631184,
NVPW_DIM_UNIT_IDC_REQUESTS = 2012649669,
NVPW_DIM_UNIT_INSTRUCTIONS = 1418625543,
NVPW_DIM_UNIT_L1DATA_BANK_ACCESSES = 1479493682,
NVPW_DIM_UNIT_L1DATA_BANK_CONFLICTS = 3433170787,
NVPW_DIM_UNIT_L1TEX_REQUESTS = 1306473767,
NVPW_DIM_UNIT_L1TEX_TAGS = 26573010,
NVPW_DIM_UNIT_L1TEX_WAVEFRONTS = 129373765,
NVPW_DIM_UNIT_L2_REQUESTS = 1143695106,
NVPW_DIM_UNIT_L2_SECTORS = 3424101564,
NVPW_DIM_UNIT_L2_TAGS = 3755612781,
NVPW_DIM_UNIT_NANOSECONDS = 3047500672,
NVPW_DIM_UNIT_NVLRX_CYCLES = 4059934930,
NVPW_DIM_UNIT_NVLTX_CYCLES = 1814350488,
NVPW_DIM_UNIT_PCIE_CYCLES = 1230450943,
NVPW_DIM_UNIT_PERCENT = 1284354694,
NVPW_DIM_UNIT_PIXELS = 4227616663,
NVPW_DIM_UNIT_PIXEL_SHADER_BARRIERS = 3705502518,
NVPW_DIM_UNIT_PRIMITIVES = 2373084002,
NVPW_DIM_UNIT_QUADS = 1539753497,
NVPW_DIM_UNIT_REGISTERS = 2837260947,
NVPW_DIM_UNIT_SAMPLES = 746046551,
NVPW_DIM_UNIT_SECONDS = 1164825258,
NVPW_DIM_UNIT_SYS_CYCLES = 3310821688,
NVPW_DIM_UNIT_TEXELS = 1293214069,
NVPW_DIM_UNIT_THREADS = 164261907,
NVPW_DIM_UNIT_VERTICES = 1873662209,
NVPW_DIM_UNIT_WARPS = 97951949,
NVPW_DIM_UNIT_WORKLOADS = 1728142656
} NVPW_DimUnitName;
#endif //NVPW_DIM_UNIT_DEFINED
#ifndef NVPW_HW_UNIT_DEFINED
#define NVPW_HW_UNIT_DEFINED
typedef enum NVPW_HwUnit
{
NVPW_HW_UNIT_INVALID = 3498035701,
NVPW_HW_UNIT_CROP = 2872137846,
NVPW_HW_UNIT_DRAM = 1662616918,
NVPW_HW_UNIT_DRAMC = 1401232876,
NVPW_HW_UNIT_FBP = 2947194306,
NVPW_HW_UNIT_FBPA = 690045803,
NVPW_HW_UNIT_FE = 2204924321,
NVPW_HW_UNIT_GPC = 1911735839,
NVPW_HW_UNIT_GPU = 1014363534,
NVPW_HW_UNIT_GR = 2933618517,
NVPW_HW_UNIT_IDC = 842765289,
NVPW_HW_UNIT_L1TEX = 893940957,
NVPW_HW_UNIT_LTS = 2333266697,
NVPW_HW_UNIT_NVLRX = 3091684901,
NVPW_HW_UNIT_NVLTX = 869679659,
NVPW_HW_UNIT_PCIE = 3433264174,
NVPW_HW_UNIT_PDA = 345193251,
NVPW_HW_UNIT_PES = 804128425,
NVPW_HW_UNIT_PROP = 3339255507,
NVPW_HW_UNIT_RASTER = 187932504,
NVPW_HW_UNIT_SM = 724224710,
NVPW_HW_UNIT_SMSP = 2837616917,
NVPW_HW_UNIT_SYS = 768990063,
NVPW_HW_UNIT_TPC = 1889024613,
NVPW_HW_UNIT_VAF = 753670509,
NVPW_HW_UNIT_VPC = 275561583,
NVPW_HW_UNIT_ZROP = 979500456
} NVPW_HwUnit;
#endif //NVPW_HW_UNIT_DEFINED
typedef enum NVPW_RollupOp
{
NVPW_ROLLUP_OP_AVG = 0,
NVPW_ROLLUP_OP_MAX,
NVPW_ROLLUP_OP_MIN,
NVPW_ROLLUP_OP_SUM,
NVPW_ROLLUP_OP__COUNT
} NVPW_RollupOp;
typedef enum NVPW_MetricType
{
NVPW_METRIC_TYPE_COUNTER = 0,
NVPW_METRIC_TYPE_RATIO,
NVPW_METRIC_TYPE_THROUGHPUT,
NVPW_METRIC_TYPE__COUNT
} NVPW_MetricType;
typedef enum NVPW_Submetric
{
NVPW_SUBMETRIC_NONE = 0,
NVPW_SUBMETRIC_PEAK_SUSTAINED = 1,
NVPW_SUBMETRIC_PEAK_SUSTAINED_ACTIVE = 2,
NVPW_SUBMETRIC_PEAK_SUSTAINED_ACTIVE_PER_SECOND = 3,
NVPW_SUBMETRIC_PEAK_SUSTAINED_ELAPSED = 4,
NVPW_SUBMETRIC_PEAK_SUSTAINED_ELAPSED_PER_SECOND = 5,
NVPW_SUBMETRIC_PEAK_SUSTAINED_FRAME = 6,
NVPW_SUBMETRIC_PEAK_SUSTAINED_FRAME_PER_SECOND = 7,
NVPW_SUBMETRIC_PEAK_SUSTAINED_REGION = 8,
NVPW_SUBMETRIC_PEAK_SUSTAINED_REGION_PER_SECOND = 9,
NVPW_SUBMETRIC_PER_CYCLE_ACTIVE = 10,
NVPW_SUBMETRIC_PER_CYCLE_ELAPSED = 11,
NVPW_SUBMETRIC_PER_CYCLE_IN_FRAME = 12,
NVPW_SUBMETRIC_PER_CYCLE_IN_REGION = 13,
NVPW_SUBMETRIC_PER_SECOND = 14,
NVPW_SUBMETRIC_PCT_OF_PEAK_SUSTAINED_ACTIVE = 15,
NVPW_SUBMETRIC_PCT_OF_PEAK_SUSTAINED_ELAPSED = 16,
NVPW_SUBMETRIC_PCT_OF_PEAK_SUSTAINED_FRAME = 17,
NVPW_SUBMETRIC_PCT_OF_PEAK_SUSTAINED_REGION = 18,
NVPW_SUBMETRIC_MAX_RATE = 19,
NVPW_SUBMETRIC_PCT = 20,
NVPW_SUBMETRIC_RATIO = 21,
NVPW_SUBMETRIC__COUNT
} NVPW_Submetric;
typedef struct NVPW_MetricEvalRequest
{
/// the metric index as in 'NVPW_MetricsEvaluator_GetMetricNames'
size_t metricIndex;
/// one of 'NVPW_MetricType'
uint8_t metricType;
/// one of 'NVPW_RollupOp', required for Counter and Throughput, doesn't apply to Ratio
uint8_t rollupOp;
/// one of 'NVPW_Submetric', required for Ratio and Throughput, optional for Counter
uint16_t submetric;
} NVPW_MetricEvalRequest;
#define NVPW_MetricEvalRequest_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_MetricEvalRequest, submetric)
typedef struct NVPW_DimUnitFactor
{
/// one of 'NVPW_DimUnitName'
uint32_t dimUnit;
int8_t exponent;
} NVPW_DimUnitFactor;
#define NVPW_DimUnitFactor_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_DimUnitFactor, exponent)
typedef struct NVPW_MetricsEvaluator_Destroy_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [in]
struct NVPW_MetricsEvaluator* pMetricsEvaluator;
} NVPW_MetricsEvaluator_Destroy_Params;
#define NVPW_MetricsEvaluator_Destroy_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_MetricsEvaluator_Destroy_Params, pMetricsEvaluator)
NVPA_Status NVAPI NVPW_MetricsEvaluator_Destroy(NVPW_MetricsEvaluator_Destroy_Params* pParams);
typedef struct NVPW_MetricsEvaluator_GetMetricNames_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [in]
struct NVPW_MetricsEvaluator* pMetricsEvaluator;
/// [in] one of 'NVPW_MetricType'
uint8_t metricType;
/// [out]
const char* pMetricNames;
/// [out]
const size_t* pMetricNameBeginIndices;
/// [out]
size_t numMetrics;
} NVPW_MetricsEvaluator_GetMetricNames_Params;
#define NVPW_MetricsEvaluator_GetMetricNames_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_MetricsEvaluator_GetMetricNames_Params, numMetrics)
NVPA_Status NVAPI NVPW_MetricsEvaluator_GetMetricNames(NVPW_MetricsEvaluator_GetMetricNames_Params* pParams);
typedef struct NVPW_MetricsEvaluator_GetMetricTypeAndIndex_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [in]
struct NVPW_MetricsEvaluator* pMetricsEvaluator;
/// [in] can be either a base metric or a metric
const char* pMetricName;
/// [out] one of 'NVPW_MetricType'
uint8_t metricType;
/// [out] the metric index as in 'NVPW_MetricsEvaluator_GetMetricNames'
size_t metricIndex;
} NVPW_MetricsEvaluator_GetMetricTypeAndIndex_Params;
#define NVPW_MetricsEvaluator_GetMetricTypeAndIndex_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_MetricsEvaluator_GetMetricTypeAndIndex_Params, metricIndex)
NVPA_Status NVAPI NVPW_MetricsEvaluator_GetMetricTypeAndIndex(NVPW_MetricsEvaluator_GetMetricTypeAndIndex_Params* pParams);
typedef struct NVPW_MetricsEvaluator_ConvertMetricNameToMetricEvalRequest_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [in]
struct NVPW_MetricsEvaluator* pMetricsEvaluator;
/// [in]
const char* pMetricName;
/// [inout] 'pMetricEvalRequest' is in, '*pMetricEvalRequest' is out
struct NVPW_MetricEvalRequest* pMetricEvalRequest;
/// [in] set to 'NVPW_MetricEvalRequest_STRUCT_SIZE'
size_t metricEvalRequestStructSize;
} NVPW_MetricsEvaluator_ConvertMetricNameToMetricEvalRequest_Params;
#define NVPW_MetricsEvaluator_ConvertMetricNameToMetricEvalRequest_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_MetricsEvaluator_ConvertMetricNameToMetricEvalRequest_Params, metricEvalRequestStructSize)
NVPA_Status NVAPI NVPW_MetricsEvaluator_ConvertMetricNameToMetricEvalRequest(NVPW_MetricsEvaluator_ConvertMetricNameToMetricEvalRequest_Params* pParams);
typedef struct NVPW_MetricsEvaluator_HwUnitToString_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [in]
struct NVPW_MetricsEvaluator* pMetricsEvaluator;
/// [in] one of 'NVPW_HwUnit'
uint32_t hwUnit;
/// [out]
const char* pHwUnitName;
} NVPW_MetricsEvaluator_HwUnitToString_Params;
#define NVPW_MetricsEvaluator_HwUnitToString_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_MetricsEvaluator_HwUnitToString_Params, pHwUnitName)
NVPA_Status NVAPI NVPW_MetricsEvaluator_HwUnitToString(NVPW_MetricsEvaluator_HwUnitToString_Params* pParams);
typedef struct NVPW_MetricsEvaluator_GetCounterProperties_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [in]
struct NVPW_MetricsEvaluator* pMetricsEvaluator;
/// [in] the metric index as in 'NVPW_MetricsEvaluator_GetMetricNames'
size_t counterIndex;
/// [out]
const char* pDescription;
/// [out] one of 'NVPW_HwUnit'
uint32_t hwUnit;
} NVPW_MetricsEvaluator_GetCounterProperties_Params;
#define NVPW_MetricsEvaluator_GetCounterProperties_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_MetricsEvaluator_GetCounterProperties_Params, hwUnit)
NVPA_Status NVAPI NVPW_MetricsEvaluator_GetCounterProperties(NVPW_MetricsEvaluator_GetCounterProperties_Params* pParams);
typedef struct NVPW_MetricsEvaluator_GetRatioMetricProperties_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [in]
struct NVPW_MetricsEvaluator* pMetricsEvaluator;
/// [in] the metric index as in 'NVPW_MetricsEvaluator_GetMetricNames'
size_t ratioMetricIndex;
/// [out]
const char* pDescription;
/// [out]
uint64_t hwUnit;
} NVPW_MetricsEvaluator_GetRatioMetricProperties_Params;
#define NVPW_MetricsEvaluator_GetRatioMetricProperties_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_MetricsEvaluator_GetRatioMetricProperties_Params, hwUnit)
NVPA_Status NVAPI NVPW_MetricsEvaluator_GetRatioMetricProperties(NVPW_MetricsEvaluator_GetRatioMetricProperties_Params* pParams);
typedef struct NVPW_MetricsEvaluator_GetThroughputMetricProperties_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [in]
struct NVPW_MetricsEvaluator* pMetricsEvaluator;
/// [in] the metric index as in 'NVPW_MetricsEvaluator_GetMetricNames'
size_t throughputMetricIndex;
/// [out]
const char* pDescription;
/// [out]
uint32_t hwUnit;
} NVPW_MetricsEvaluator_GetThroughputMetricProperties_Params;
#define NVPW_MetricsEvaluator_GetThroughputMetricProperties_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_MetricsEvaluator_GetThroughputMetricProperties_Params, hwUnit)
NVPA_Status NVAPI NVPW_MetricsEvaluator_GetThroughputMetricProperties(NVPW_MetricsEvaluator_GetThroughputMetricProperties_Params* pParams);
typedef struct NVPW_MetricsEvaluator_GetSupportedSubmetrics_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [in]
struct NVPW_MetricsEvaluator* pMetricsEvaluator;
/// [in] one of 'NVPW_MetricType'
uint8_t metricType;
/// [out] an array of 'NVPW_Submetric'
const uint16_t* pSupportedSubmetrics;
/// [out]
size_t numSupportedSubmetrics;
} NVPW_MetricsEvaluator_GetSupportedSubmetrics_Params;
#define NVPW_MetricsEvaluator_GetSupportedSubmetrics_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_MetricsEvaluator_GetSupportedSubmetrics_Params, numSupportedSubmetrics)
NVPA_Status NVAPI NVPW_MetricsEvaluator_GetSupportedSubmetrics(NVPW_MetricsEvaluator_GetSupportedSubmetrics_Params* pParams);
typedef struct NVPW_MetricsEvaluator_GetMetricRawDependencies_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [in]
struct NVPW_MetricsEvaluator* pMetricsEvaluator;
/// [in]
const struct NVPW_MetricEvalRequest* pMetricEvalRequests;
/// [in]
size_t numMetricEvalRequests;
/// [in] set to 'NVPW_MetricEvalRequest_STRUCT_SIZE'
size_t metricEvalRequestStructSize;
/// [in] set to sizeof('NVPW_MetricEvalRequest')
size_t metricEvalRequestStrideSize;
/// [inout] 'ppRawDependencies' is in, '*ppRawDependencies' is out
const char** ppRawDependencies;
/// [inout] if 'ppRawDependencies' is NULL, number of raw dependencies available will be returned; otherwise it
/// should be set to the number of elements allocated for 'ppRawDependencies', and on return, it will be
/// overwritten by number of elements copied to 'ppRawDependencies'
size_t numRawDependencies;
} NVPW_MetricsEvaluator_GetMetricRawDependencies_Params;
#define NVPW_MetricsEvaluator_GetMetricRawDependencies_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_MetricsEvaluator_GetMetricRawDependencies_Params, numRawDependencies)
NVPA_Status NVAPI NVPW_MetricsEvaluator_GetMetricRawDependencies(NVPW_MetricsEvaluator_GetMetricRawDependencies_Params* pParams);
typedef struct NVPW_MetricsEvaluator_DimUnitToString_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [in]
struct NVPW_MetricsEvaluator* pMetricsEvaluator;
/// [in] one of 'NVPW_DimUnitName'
uint32_t dimUnit;
/// [out]
const char* pSingularName;
/// [out]
const char* pPluralName;
} NVPW_MetricsEvaluator_DimUnitToString_Params;
#define NVPW_MetricsEvaluator_DimUnitToString_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_MetricsEvaluator_DimUnitToString_Params, pPluralName)
NVPA_Status NVAPI NVPW_MetricsEvaluator_DimUnitToString(NVPW_MetricsEvaluator_DimUnitToString_Params* pParams);
typedef struct NVPW_MetricsEvaluator_GetMetricDimUnits_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [in]
struct NVPW_MetricsEvaluator* pMetricsEvaluator;
/// [in]
const struct NVPW_MetricEvalRequest* pMetricEvalRequest;
/// [in] set to 'NVPW_MetricEvalRequest_STRUCT_SIZE'
size_t metricEvalRequestStructSize;
/// [inout] 'pDimUnits' is in, '*pDimUnits' is out
NVPW_DimUnitFactor* pDimUnits;
/// [inout] if 'pDimUnits' is NULL, number of dim-units available will be returned; otherwise it should be set
/// to the number of elements allocated for 'pDimUnits', and on return, it will be overwritten by number of
/// elements copied to 'pDimUnits'
size_t numDimUnits;
/// [in] set to 'NVPW_DimUnitFactor_STRUCT_SIZE'
size_t dimUnitFactorStructSize;
} NVPW_MetricsEvaluator_GetMetricDimUnits_Params;
#define NVPW_MetricsEvaluator_GetMetricDimUnits_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_MetricsEvaluator_GetMetricDimUnits_Params, dimUnitFactorStructSize)
NVPA_Status NVAPI NVPW_MetricsEvaluator_GetMetricDimUnits(NVPW_MetricsEvaluator_GetMetricDimUnits_Params* pParams);
typedef struct NVPW_MetricsEvaluator_SetUserData_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [in]
struct NVPW_MetricsEvaluator* pMetricsEvaluator;
/// [in] duration in ns of user defined frame
double frameDuration;
/// [in] duration in ns of user defined region
double regionDuration;
/// [in]
NVPA_Bool isolated;
} NVPW_MetricsEvaluator_SetUserData_Params;
#define NVPW_MetricsEvaluator_SetUserData_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_MetricsEvaluator_SetUserData_Params, isolated)
NVPA_Status NVAPI NVPW_MetricsEvaluator_SetUserData(NVPW_MetricsEvaluator_SetUserData_Params* pParams);
typedef struct NVPW_MetricsEvaluator_EvaluateToGpuValues_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [in]
struct NVPW_MetricsEvaluator* pMetricsEvaluator;
/// [in]
const struct NVPW_MetricEvalRequest* pMetricEvalRequests;
/// [in]
size_t numMetricEvalRequests;
/// [in] set to 'NVPW_MetricEvalRequest_STRUCT_SIZE'
size_t metricEvalRequestStructSize;
/// [in] set to sizeof('NVPW_MetricEvalRequest')
size_t metricEvalRequestStrideSize;
/// [in]
const uint8_t* pCounterDataImage;
/// [in]
size_t counterDataImageSize;
/// [in]
size_t rangeIndex;
/// [in]
NVPA_Bool isolated;
/// [inout] 'pMetricValues' is in, '*pMetricValues' is out
double* pMetricValues;
} NVPW_MetricsEvaluator_EvaluateToGpuValues_Params;
#define NVPW_MetricsEvaluator_EvaluateToGpuValues_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_MetricsEvaluator_EvaluateToGpuValues_Params, pMetricValues)
NVPA_Status NVAPI NVPW_MetricsEvaluator_EvaluateToGpuValues(NVPW_MetricsEvaluator_EvaluateToGpuValues_Params* pParams);
typedef struct NVPW_MetricsEvaluator_SetDeviceAttributes_Params
{
/// [in]
size_t structSize;
/// [in] assign to NULL
void* pPriv;
/// [in]
struct NVPW_MetricsEvaluator* pMetricsEvaluator;
/// [in]
const uint8_t* pCounterDataImage;
/// [in]
size_t counterDataImageSize;
} NVPW_MetricsEvaluator_SetDeviceAttributes_Params;
#define NVPW_MetricsEvaluator_SetDeviceAttributes_Params_STRUCT_SIZE NVPA_STRUCT_SIZE(NVPW_MetricsEvaluator_SetDeviceAttributes_Params, counterDataImageSize)
NVPA_Status NVAPI NVPW_MetricsEvaluator_SetDeviceAttributes(NVPW_MetricsEvaluator_SetDeviceAttributes_Params* pParams);
/**
* @}
******************************************************************************/
#endif // NVPERF_HOST_API_DEFINED
#ifdef __cplusplus
} // extern "C"
#endif
#if defined(__GNUC__) && defined(NVPA_SHARED_LIB)
#pragma GCC visibility pop
#endif
#endif // NVPERF_HOST_H
Reference in New Issue View Git Blame Copy Permalink