#pragma once

// =========================================================================================
//!  FvSDK Version Definition
//!  Maintain per structure specific version define using the MAKE_FVSDK_VERSION macro.
// =========================================================================================
#define MAKE_FVSDK_VERSION(typeName,ver) (unsigned int)(sizeof(typeName) | ((ver)<<16))
#define GET_FVSDK_VERSION(ver) (unsigned int)((ver)>>16)
#define GET_FVSDK_SIZE(ver) (unsigned int)((ver) & 0xffff)

#define FV_DECLARE_HANDLE(name) struct name##__ { int unused; }; typedef struct name##__ *name

//! \addtogroup fvsdkhandles
//! FVSDK session handle - opaque type Do not assume this corresponds to any data
FV_DECLARE_HANDLE(FvSession);

// =========================================================================================
//!  FvStatus - error codes
// =========================================================================================

typedef enum FvStatus
{
    FV_SUCCESS                  = 0x00000000L,
    FV_CREATE_SESSION_FAILED    = 0x00000001L,
    FV_MORE_DATA                = 0x00000002L,
    FV_NO_DATA                  = 0x00000003L,
    FV_INVALID_SESSION          = 0x00000004L,
    FV_NOT_IMPLEMENTED          = 0x00000005L,
    FV_LIBRARY_NOT_FOUND        = 0x00000006L,
    FV_SERVICE_ERROR            = 0x00000007L,
    FV_INVALID_METRIC           = 0x00000008L,
    FV_METRIC_NOT_ENABLED       = 0x00000009L,
    FV_BENCHMARK_IN_PROGRESS    = 0x0000000AL,
    FV_BENCHMARK_NOT_STARTED    = 0x0000000BL,
    FV_INSUFFICIENT_BUFFER      = 0x00000010L,
    FV_INVALID_VERSION          = 0x00000011L,
    FV_ERROR                    = 0xFFFFFFFFL,
} FvStatus;

#define FVSDK_INTERFACE FvStatus __cdecl

//! Used in ReadData() to specify sample type
typedef enum _FvMetricType
{
    eInvalid                 =  0x00000000,  //!< Invalid metrics
    eFrame                   =  0x5BE0DB9E,  //!< Per frame data
    eAvgFPS                  =  0x6C4B1348,  //!< Avg FPS
    eFPS99                   =  0xCA3E085A,  //!< 99 percentile FPS
    eRenderPresentLatency    =  0x92E4D2CA,  //!< Render Present Latency
    eRenderLatency           =  0x4724DF89,  //!< Render Latency
    eGPUFreq                 =  0x567A179A,  //!< GPC clocks in MHz
    eGPUTemp                 =  0x0ADD87E5,  //!< GPU temperature in celsius
    eGPUUtil                 =  0xDFE8B08C,  //!< GPC utilization
    eGPUMemFreq              =  0x933377A0,  //!< GPU Memory clock in MHz
    eGPUVoltage              =  0x06BF2EBE,  //!< GPU Voltage in millivolts
    eGPUFanSpeed             =  0x4D8E9794,  //!< Fan Speed in RPM 
    eTGPWatts                =  0x74BDB13C,  //!< Total board power
    eCPUUtil                 =  0x2BA7949F,  //!< CPU utilization
    ePCDisplayLatency        =  0x77CB544C,  //!< PC display latency
    eMouseLatency            =  0x55E47126,  //!< Mouse latency
    eE2ESystemLatency        =  0x168AFD5E,  //!< E2E system latency
    eLAMMonitoringRect       =  0x8CC2E8B7,  //!< LAM monitoring rect
    eLAMInfo                 =  0x501A6AFF,  //!< LAM info
    eAvgPCDisplayLatency     =  0x3CBDCA04,  //!< Average PC Latency
    eAvgMouseLatency         =  0xF4C2C14D,  //!< Average Mouse Latency
    eAvgE2ESystemLatency     =  0x5DFC6316,  //!< Average E2E System Latency
    eProcessName             =  0xA98734CD,  //!< Process name as metric
    eAvgSWPCLatency          =  0x363AFFA0,  //!< Average SW based PC Latency
} FvMetricType;

//! Used in SampleData()
typedef enum _FvSampleDataFlags {
    FVSDK_SAMPLEDATA_DONOTWAIT  =   0,  //!< Do not block in SampleData API
} FvSampleDataFlags;

//! Used in StartBenchmark()
typedef enum _FvBenchmarkFlags {
    FVSDK_BENCHMARKFLAGS_NONE           = 0,
    FVSDK_BENCHMARKFLAGS_PER_FRAME_DATA = 1,  //!< Collect per frame data
} FvBenchmarkFlags;

// =========================================================================================
//!  BaseMetric - base of all metrics supported by SDK
// =========================================================================================

struct BaseMetric_v1
{
    unsigned int                  baseversion;        //!< The structure version.
    unsigned long long int        mTimestamp;         //!< QPC timestamp when metric was collected.
    BaseMetric_v1()
    {
        baseversion = MAKE_FVSDK_VERSION(BaseMetric_v1, 1);
    }
};

#define FVSDK_BASEMETRIC_VER_1   MAKE_FVSDK_VERSION(BaseMetric_v1, 1)

// =========================================================================================
//!  BaseMetric - base of all metrics supported by SDK - version 2
// =========================================================================================

struct BaseMetric_v2
{
    unsigned int                  baseversion;        //!< The structure version.
    unsigned long long int        mTimestamp;         //!< QPC timestamp when metric was collected.
    double                        minValue;           //!< Advance statistics for the metric
    double                        maxValue;
    double                        avgValue;
    double                        stdDeviation;
    BaseMetric_v2()
    {
        baseversion = MAKE_FVSDK_VERSION(BaseMetric_v2, 2);
    }
};

#define FVSDK_BASEMETRIC_VER_2   MAKE_FVSDK_VERSION(BaseMetric_v2, 2)
#define FVSDK_BASEMETRIC_VER     FVSDK_BASEMETRIC_VER_2
typedef BaseMetric_v2   BaseMetric;

// =========================================================================================
//!  Samples - collection of samples of particular metric
//!  Used in ReadData() call
//!  mData - pointer to array of structures of type metric
// =========================================================================================

struct Samples_v1
{
    unsigned int    version;            //!< The structure version.
    FvMetricType    type;               //!< Type of metric, client needs to set this.
    size_t          mNumSamples;        //!< Number of samples of type metric.
    void*           mData;
    Samples_v1()
    {
        version = MAKE_FVSDK_VERSION(Samples_v1, 1);
        mData = 0;
        mNumSamples = 0;
    }
};
#define FVSDK_SAMPLES_VER_1   MAKE_FVSDK_VERSION(Samples_v1, 1)
#define FVSDK_SAMPLES_VER     FVSDK_SAMPLES_VER_1
typedef Samples_v1   Samples;

// =========================================================================================
//!  FPS - provides additional information about process
// =========================================================================================

struct FPS_v1
{
    unsigned int              version;
    unsigned long long int    PID;
    unsigned long long int    SwapChain;
    double                    AvgFPS;
    FPS_v1()
    {
        version = MAKE_FVSDK_VERSION(FPS_v1, 1);
    }
};
#define FVSDK_FPS_VER_1   MAKE_FVSDK_VERSION(FPS_v1, 1)
#define FVSDK_FPS_VER     FVSDK_FPS_VER_1
typedef FPS_v1   FPS;

// =========================================================================================
//!  FPS metric - render average
// =========================================================================================

struct AvgFPS_v1 : BaseMetric_v1
{
    unsigned int version;
    FPS mFPS;
    AvgFPS_v1()
    {
        version = MAKE_FVSDK_VERSION(AvgFPS_v1, 1);
    }
};
#define FVSDK_AVGFPS_VER_1   MAKE_FVSDK_VERSION(AvgFPS_v1, 1)
#define FVSDK_AVGFPS_VER     FVSDK_AVGFPS_VER_1
typedef AvgFPS_v1   AvgFPS;

// =========================================================================================
//!  FPS - render 99 percentile
// =========================================================================================

struct FPS99_v1 : BaseMetric_v1
{
    unsigned int version;
    FPS mFPS;
    FPS99_v1()
    {
        version = MAKE_FVSDK_VERSION(FPS99_v1, 1);
    }
};
#define FVSDK_FPS99_VER_1   MAKE_FVSDK_VERSION(FPS99_v1, 1)
#define FVSDK_FPS99_VER     FVSDK_FPS99_VER_1
typedef FPS99_v1   FPS99;

// =========================================================================================
//!  FPS - render latency
// =========================================================================================

struct RenderLatency_v1 : BaseMetric_v1
{
    unsigned int version;
    FPS mFPS;
    RenderLatency_v1()
    {
        version = MAKE_FVSDK_VERSION(RenderLatency_v1, 1);
    }
};
#define FVSDK_RENDERLATENCY_VER_1   MAKE_FVSDK_VERSION(RenderLatency_v1, 1)
#define FVSDK_RENDERLATENCY_VER     FVSDK_RENDERLATENCY_VER_1
typedef RenderLatency_v1   RenderLatency;

// =========================================================================================
//!  FPS - render present latency
// =========================================================================================

struct RenderPresentLatency_v1 : BaseMetric_v1
{
    unsigned int version;
    FPS mFPS;
    RenderPresentLatency_v1()
    {
        version = MAKE_FVSDK_VERSION(RenderPresentLatency_v1, 1);
    }
};
#define FVSDK_RENDERPRESENTLATENCY_VER_1   MAKE_FVSDK_VERSION(RenderLatency_v1, 1)
#define FVSDK_RENDERPRESENTLATENCY_VER     FVSDK_RENDERPRESENTLATENCY_VER_1
typedef RenderPresentLatency_v1   RenderPresentLatency;

// =========================================================================================
//!  LAM metric - info
// =========================================================================================

struct LAMInfo_v1 : BaseMetric_v1
{
    unsigned int version;
    bool         on;
    LAMInfo_v1()
    {
        version = MAKE_FVSDK_VERSION(LAMInfo_v1, 1);
    }
};
#define FVSDK_LAMINFO_VER_1   MAKE_FVSDK_VERSION(LAMInfo_v1, 1)
#define FVSDK_LAMINFO_VER     FVSDK_LAMINFO_VER_1
typedef LAMInfo_v1   LAMInfo;

// =========================================================================================
//!  LAM metric - PC Display latency
// =========================================================================================

struct PCDisplayLatency_v1 : BaseMetric_v1
{
    unsigned int version;
    double latency;
    PCDisplayLatency_v1()
    {
        version = MAKE_FVSDK_VERSION(PCDisplayLatency_v1, 1);
    }
};
struct PCDisplayLatency_v2 : BaseMetric_v2
{
    unsigned int version;
    double latency;
    PCDisplayLatency_v2()
    {
        version = MAKE_FVSDK_VERSION(PCDisplayLatency_v2, 2);
    }
};
#define FVSDK_PCDISPLAYLATENCY_VER_1   MAKE_FVSDK_VERSION(PCDisplayLatency_v1, 1)
#define FVSDK_PCDISPLAYLATENCY_VER_2   MAKE_FVSDK_VERSION(PCDisplayLatency_v2, 2)
#define FVSDK_PCDISPLAYLATENCY_VER     FVSDK_PCDISPLAYLATENCY_VER_2
typedef PCDisplayLatency_v2   PCDisplayLatency;

// =========================================================================================
//!  Average Software based PC latency
// =========================================================================================

struct AvgSWPCLatency_v1 : BaseMetric_v1
{
    unsigned int version;
    FPS mFPS;
    AvgSWPCLatency_v1()
    {
        version = MAKE_FVSDK_VERSION(AvgSWPCLatency_v1, 1);
    }
};
#define FVSDK_AVGSWPCLATENCY_VER_1   MAKE_FVSDK_VERSION(AvgSWPCLatency_v1, 1)
#define FVSDK_AVGSWPCLATENCY_VER     FVSDK_PCDISPLAYLATENCY_VER_1
typedef AvgSWPCLatency_v1   AvgSWPCLatency;


// =========================================================================================
//!  LAM metric - Mouse latency
// =========================================================================================

struct MouseLatency_v1 : BaseMetric_v1
{
    unsigned int version;
    double latency;
    unsigned int lut;
    unsigned int unverifiedFW;
    MouseLatency_v1()
    {
        version = MAKE_FVSDK_VERSION(MouseLatency_v1, 1);
    }
};
struct MouseLatency_v2 : BaseMetric_v2
{
    unsigned int version;
    double latency;
    unsigned int lut;
    unsigned int unverifiedFW;
    MouseLatency_v2()
    {
        version = MAKE_FVSDK_VERSION(MouseLatency_v2, 2);
    }
};
#define FVSDK_MOUSELATENCY_VER_1   MAKE_FVSDK_VERSION(MouseLatency_v1, 1)
#define FVSDK_MOUSELATENCY_VER_2   MAKE_FVSDK_VERSION(MouseLatency_v2, 2)
#define FVSDK_MOUSELATENCY_VER     FVSDK_MOUSELATENCY_VER_2
typedef MouseLatency_v2   MouseLatency;

// =========================================================================================
//!  LAM metric - End to end system latency
// =========================================================================================

struct E2ESystemLatency_v1 : BaseMetric_v1
{
    unsigned int version;
    double latency;
    E2ESystemLatency_v1()
    {
        version = MAKE_FVSDK_VERSION(E2ESystemLatency_v1, 1);
    }
};
struct E2ESystemLatency_v2 : BaseMetric_v2
{
    unsigned int version;
    double latency;
    E2ESystemLatency_v2()
    {
        version = MAKE_FVSDK_VERSION(E2ESystemLatency_v2, 2);
    }
};
#define FVSDK_E2ESYSTEMLATENCY_VER_1   MAKE_FVSDK_VERSION(E2ESystemLatency_v1, 1)
#define FVSDK_E2ESYSTEMLATENCY_VER_2   MAKE_FVSDK_VERSION(E2ESystemLatency_v2, 2)
#define FVSDK_E2ESYSTEMLATENCY_VER     FVSDK_E2ESYSTEMLATENCY_VER_2
typedef E2ESystemLatency_v2   E2ESystemLatency;

// =========================================================================================
//!  LAM metric - Average PC latency
// =========================================================================================

struct AvgPCDisplayLatency_v1 : BaseMetric_v1
{
    unsigned int version;
    double latency;
    AvgPCDisplayLatency_v1()
    {
        version = MAKE_FVSDK_VERSION(AvgPCDisplayLatency_v1, 1);
    }
};
#define FVSDK_AVGPCDISPLAYLATENCY_VER_1   MAKE_FVSDK_VERSION(AvgPCDisplayLatency_v1, 1)
#define FVSDK_AVGPCDISPLAYLATENCY_VER     FVSDK_AVGPCDISPLAYLATENCY_VER_1
typedef AvgPCDisplayLatency_v1   AvgPCDisplayLatency;

// =========================================================================================
//!  LAM metric - Averagege Mouse latency
// =========================================================================================

struct AvgMouseLatency_v1 : BaseMetric_v1
{
    unsigned int version;
    double latency;
    unsigned int polledActuation;
    AvgMouseLatency_v1()
    {
        version = MAKE_FVSDK_VERSION(AvgMouseLatency_v1, 1);
    }
};
#define FVSDK_AVGMOUSELATENCY_VER_1   MAKE_FVSDK_VERSION(AvgMouseLatency_v1, 1)
#define FVSDK_AVGMOUSELATENCY_VER     FVSDK_AVGMOUSELATENCY_VER_1
typedef AvgMouseLatency_v1   AvgMouseLatency;

// =========================================================================================
//!  LAM metric - End to end system latency
// =========================================================================================

struct AvgE2ESystemLatency_v1 : BaseMetric_v1
{
    unsigned int version;
    double latency;
    AvgE2ESystemLatency_v1()
    {
        version = MAKE_FVSDK_VERSION(AvgE2ESystemLatency_v1, 1);
    }
};
#define FVSDK_AVGE2ESYSTEMLATENCY_VER_1   MAKE_FVSDK_VERSION(AvgE2ESystemLatency_v1, 1)
#define FVSDK_AVGE2ESYSTEMLATENCY_VER     FVSDK_AVGE2ESYSTEMLATENCY_VER_1
typedef AvgE2ESystemLatency_v1   AvgE2ESystemLatency;

// =========================================================================================
//!  LAM metric - Monitoring rectangle
// =========================================================================================

struct LAMMonitoringRect_v1 : BaseMetric_v1
{
    unsigned int version;
    int width;
    int height;
    int topleftx;
    int toplefty;
    LAMMonitoringRect_v1()
    {
        version = MAKE_FVSDK_VERSION(LAMMonitoringRect_v1, 1);
    }
};
#define FVSDK_LAMMONITORINGRECT_VER_1   MAKE_FVSDK_VERSION(LAMMonitoringRect_v1, 1)
#define FVSDK_LAMMONITORINGRECT_VER     FVSDK_LAMMONITORINGRECT_VER_1
typedef LAMMonitoringRect_v1   LAMMonitoringRect;

// =========================================================================================
//!  ProcessName_v1
// =========================================================================================

#define FVSDK_PROCESS_NAME_SIZE 256

struct ProcessName_v1 : BaseMetric_v1
{
    unsigned int                version;
    unsigned long long int      PID;
    char                        name[FVSDK_PROCESS_NAME_SIZE];
    ProcessName_v1()
    {
        version = MAKE_FVSDK_VERSION(ProcessName_v1, 1);
    }
};

#define FVSDK_PROCESSNAME_VER_1   MAKE_FVSDK_VERSION(ProcessName_v1, 1)
#define FVSDK_PROCESSNAME_VER     FVSDK_PROCESSNAME_VER_1
typedef ProcessName_v1   ProcessName;

// =========================================================================================
//!  GPUTempC
// =========================================================================================

struct GPUTemp_v1 : BaseMetric_v1
{
    unsigned int    version;
    unsigned int    mVendorId;
    size_t          mGPUIndex;
    double          mGPUTemp;
    GPUTemp_v1()
    {
        version = MAKE_FVSDK_VERSION(GPUTemp_v1, 1);
    }
};

#define FVSDK_GPUTEMP_VER_1   MAKE_FVSDK_VERSION(GPUTemp_v1, 1)
#define FVSDK_GPUTEMP_VER     FVSDK_GPUTEMP_VER_1
typedef GPUTemp_v1   GPUTemp;

// =========================================================================================
//!  GPUUtil
// =========================================================================================

struct GPUUtil_v1 : BaseMetric_v1
{
    unsigned int    version;
    unsigned int    mVendorId;
    size_t          mGPUIndex;
    double          mGPUUtil;
    GPUUtil_v1()
    {
        version = MAKE_FVSDK_VERSION(GPUUtil_v1, 1);
    }
};

#define FVSDK_GPUUTIL_VER_1   MAKE_FVSDK_VERSION(GPUUtil_v1, 1)
#define FVSDK_GPUUTIL_VER     FVSDK_GPUUTIL_VER_1
typedef GPUUtil_v1   GPUUtil;

// =========================================================================================
//!  GPUFreq
// =========================================================================================

struct GPUFreq_v1 : BaseMetric_v1
{
    unsigned int    version;
    unsigned int    mVendorId;
    size_t          mGPUIndex;
    double          mGPUFreq;
    GPUFreq_v1()
    {
        version = MAKE_FVSDK_VERSION(GPUFreq_v1, 1);
    }
};

#define FVSDK_GPUFREQ_VER_1   MAKE_FVSDK_VERSION(GPUFreq_v1, 1)
#define FVSDK_GPUFREQ_VER     FVSDK_GPUFREQ_VER_1
typedef GPUFreq_v1   GPUFreq;

// =========================================================================================
//!  GPUFanSpeed
// =========================================================================================

struct GPUFanSpeed_v1 : BaseMetric_v1
{
    unsigned int    version;
    unsigned int    mVendorId;
    size_t          mGPUIndex;
    size_t          mFanIndex;
    double          mFanSpeed;
    GPUFanSpeed_v1()
    {
        version = MAKE_FVSDK_VERSION(GPUFanSpeed_v1, 1);
    }
};

#define FVSDK_GPUFANSPEED_VER_1   MAKE_FVSDK_VERSION(GPUFanSpeed_v1, 1)
#define FVSDK_GPUFANSPEED_VER     FVSDK_GPUFANSPEED_VER_1
typedef GPUFanSpeed_v1   GPUFanSpeed;


// =========================================================================================
//!  GPUVoltage
// =========================================================================================

struct GPUVoltage_v1 : BaseMetric_v1
{
    unsigned int    version;
    unsigned int    mVendorId;
    size_t          mGPUIndex;
    double          mGPUVoltage;
    GPUVoltage_v1()
    {
        version = MAKE_FVSDK_VERSION(GPUVoltage_v1, 1);
    }
};

#define FVSDK_GPUVOLTAGE_VER_1   MAKE_FVSDK_VERSION(GPUVoltage_v1, 1)
#define FVSDK_GPUVOLTAGE_VER     FVSDK_GPUVOLTAGE_VER_1
typedef GPUVoltage_v1   GPUVoltage;


// =========================================================================================
//!  GPUMemFreq
// =========================================================================================

struct GPUMemFreq_v1 : BaseMetric_v1
{
    unsigned int    version;
    unsigned int    mVendorId;
    size_t          mGPUIndex;
    double          mGPUMemFreq;
    GPUMemFreq_v1()
    {
        version = MAKE_FVSDK_VERSION(GPUMemFreq_v1, 1);
    }
};

#define FVSDK_GPUMEMFREQ_VER_1   MAKE_FVSDK_VERSION(GPUMemFreq_v1, 1)
#define FVSDK_GPUMEMFREQ_VER     FVSDK_GPUMEMFREQ_VER_1
typedef GPUMemFreq_v1   GPUMemFreq;


// =========================================================================================
//!  CPUUtil
// =========================================================================================

struct CPUUtil_v1 : BaseMetric_v1
{
    unsigned int version;
    double mCPUUtil;
    CPUUtil_v1()
    {
        version = MAKE_FVSDK_VERSION(CPUUtil_v1, 1);
    }
};

#define FVSDK_CPUUTIL_VER_1   MAKE_FVSDK_VERSION(CPUUtil_v1, 1)
#define FVSDK_CPUUTIL_VER     FVSDK_CPUUTIL_VER_1
typedef CPUUtil_v1   CPUUtil;

// =========================================================================================
//!  TGPWatts
// =========================================================================================

struct TGPWatts_v1 : BaseMetric_v1
{
    unsigned int version;
    double mTGPWatts;
    TGPWatts_v1()
    {
        version = MAKE_FVSDK_VERSION(TGPWatts_v1, 1);
    }
};


// =========================================================================================
//!  Individual TGPWatts 
// =========================================================================================

struct TGPWatts_v2 : BaseMetric_v2
{
    unsigned int    version;
    double          mTGPWatts;
    unsigned int    mVendorId;
    size_t          mGPUIndex;
    
    TGPWatts_v2()
    {
        version = MAKE_FVSDK_VERSION(TGPWatts_v2, 2);
    }
};

#define FVSDK_TGPWATTS_VER_1   MAKE_FVSDK_VERSION(TGPWatts_v1, 1)
#define FVSDK_TGPWATTS_VER_2   MAKE_FVSDK_VERSION(TGPWatts_v2, 2)
#define FVSDK_TGPWATTS_VER    FVSDK_TGPWATTS_VER_2
typedef TGPWatts_v2   TGPWatts;

// =========================================================================================
//!  Frame
// =========================================================================================

struct Frame_v1 : BaseMetric_v1
{
    unsigned int           version;
    unsigned long long int PID;
    unsigned long long int SwapChain;
    double                 mMsBetweenPresents;
    double                 mMsBetweenDisplayChange;
    double                 mMsLaency;

    Frame_v1()
    {
        version = MAKE_FVSDK_VERSION(Frame_v1, 1);
    }
};
#define FVSDK_FRAME_VER_1   MAKE_FVSDK_VERSION(Frame_v1, 1)
#define FVSDK_FRAME_VER     FVSDK_FRAME_VER_1
typedef Frame_v1   Frame;

///////////////////////////////////////////////////////////////////////////////
//
// FUNCTION NAME:  FvSDK_Initialize
//
//!   DESCRIPTION: Loads FvSDK library
//!
//! \retval    FV_SUCCESS
//! \retval    FV_LIBRARY_NOT_FOUND
//!
///////////////////////////////////////////////////////////////////////////////
FVSDK_INTERFACE FvSDK_Initialize();

///////////////////////////////////////////////////////////////////////////////
//
// FUNCTION NAME:  FvSDK_CreateSession
//
//!   DESCRIPTION: Allocates data needed for session. FvSession handle can be 
//!                     used until call to FvSDK_DestroySession
//!
//!
//! \param [out] FvSession*
//!
//! \retval    FV_SUCCESS
//!
///////////////////////////////////////////////////////////////////////////////
FVSDK_INTERFACE FvSDK_CreateSession(FvSession*);

///////////////////////////////////////////////////////////////////////////////
//
// FUNCTION NAME:  FvSDK_StartSession
//
//!   DESCRIPTION: Starts data collection for FvSession
//!
//!
//! \param [in] FvSession
//!
//! \retval    FV_SUCCESS
//!
///////////////////////////////////////////////////////////////////////////////
FVSDK_INTERFACE FvSDK_StartSession(FvSession);


///////////////////////////////////////////////////////////////////////////////
//
// FUNCTION NAME:  FvSDK_EnableMetrics
//
//!   DESCRIPTION: Enables collection of metrics. Use FvSDK_ReadData() to read
//!                 enabled collection of metrics.
//!
//! \param [in] FvSession
//! \param [in] FvMetricType*
//! \param [in] unsigned int
//!
//! \retval    FV_SUCCESS
//! \retval    FV_NOT_IMPLEMENTED
//!
///////////////////////////////////////////////////////////////////////////////
FVSDK_INTERFACE FvSDK_EnableMetrics(FvSession, FvMetricType*, unsigned int);


// Metric specific params
// If client needs to modify these params later, they can just call FvSDK_EnableMetrics 
// with new values.
struct FvMetricParams
{
    unsigned int numMetrics;   // number of metrics
    FvMetricType* metrics;     // metrics to enable
    int* samplingWindowSize;   // sampling window size
    bool* enableAdvanceStats;  // like min,max,stddev 
};

///////////////////////////////////////////////////////////////////////////////
//
// FUNCTION NAME:  FvSDK_EnableMetrics2
//
//!   DESCRIPTION: Enables collection of metrics. Use FvSDK_ReadData() to read
//!                 enabled collection of metrics.
//!
//! \param [in] FvSession
//! \param [in] FvMetricParams
//!
//! \retval    FV_SUCCESS
//! \retval    FV_NOT_IMPLEMENTED
//!
///////////////////////////////////////////////////////////////////////////////
FVSDK_INTERFACE FvSDK_EnableMetrics2(FvSession, FvMetricParams);


///////////////////////////////////////////////////////////////////////////////
//
// FUNCTION NAME:  FvSDK_SampleData
//
//!   DESCRIPTION: Snapshots data available since last call to FvSDK_SampleData()
//!
//! \param [in] FvSession
//!
//! \retval    FV_SUCCESS
//! \retval    FV_INVALID_SESSION
//! \retval    FV_SERVICE_ERROR
//! \retval    FV_NOT_IMPLEMENTED
//!
///////////////////////////////////////////////////////////////////////////////
FVSDK_INTERFACE FvSDK_SampleData(FvSession, FvSampleDataFlags);

///////////////////////////////////////////////////////////////////////////////
//
// FUNCTION NAME:  FvSDK_ResetSampling
//
//!   DESCRIPTION: Discard the old samples
//!
//! \param [in] FvSession
//!
//! \retval    FV_SUCCESS
//! \retval    FV_INVALID_SESSION
//! \retval    FV_SERVICE_ERROR
//! \retval    FV_NOT_IMPLEMENTED
//!
///////////////////////////////////////////////////////////////////////////////
FVSDK_INTERFACE FvSDK_ResetSampling(FvSession, FvMetricType*, unsigned int);

///////////////////////////////////////////////////////////////////////////////
//
// FUNCTION NAME:  FvSDK_ReadData
//
//!   DESCRIPTION: Provides copy of data collected when FvSDK_SampleData was 
//!       called. Populate metric type field of Samples to retrieve information
//!       about metric type sample. Information provided is number of Samples
//!       mData member of Samples if not NULL should point to valid memory that
//!       can accomodate N metric type structures.
//!
//! HOW TO USE: 1. First call
//!                  a) session - a valid FvSession handle
//!                  b) pSamples - address pointing to sampleCount of Samples structure
//!                         set type member to metric type of interest
//!                         set mData member to NULL
//!                  c) sampleCount - number of Samples elements in pSamples
//!                     If all parameters are correct and this call is successful, 
//!                     this call will return FV_INSUFFICIENT_BUFFER.
//!             2. Second call
//!                  a) session - a valid FvSession handle
//!                  b) pSamples - address pointing to sampleCount of Samples structure
//!                         set type member to metric type of interest
//!                         set mData member to array of structure of metric type
//!                  c) sampleCount - number of Samples elements in pSamples
//!                     If all parameters are correct and this call is successful, 
//!                     this call will return FVSDK_SUCCESS.

//!
//! \param [in] session
//! \param [in,out] pSamples
//! \param [in] sampleCount
//!
//! \retval    FV_SUCCESS
//! \retval    FV_MORE_DATA
//! \retval    FV_INVALID_SESSION
//!
///////////////////////////////////////////////////////////////////////////////
FVSDK_INTERFACE FvSDK_ReadData(FvSession session, Samples *pSamples, unsigned int sampleCount);

///////////////////////////////////////////////////////////////////////////////
//
// FUNCTION NAME:  FvSDK_AlignLatencyMonitoringRect
//
//!   DESCRIPTION: TODO
//!
//! \param [in] session
//!
//! \retval    FV_SUCCESS
//! \retval    FV_ERROR
//!
///////////////////////////////////////////////////////////////////////////////
FVSDK_INTERFACE FvSDK_AlignLatencyMonitoringRect(FvSession session);

///////////////////////////////////////////////////////////////////////////////
//
// FUNCTION NAME:  FvSDK_StartBenchmark
//
//!   DESCRIPTION: TODO
//!
//! \param [in] session
//!
//! \retval    FV_SUCCESS
//! \retval    FV_ERROR
//!
///////////////////////////////////////////////////////////////////////////////
FVSDK_INTERFACE FvSDK_StartBenchmark(FvSession session, FvBenchmarkFlags flags);

///////////////////////////////////////////////////////////////////////////////
//
// FUNCTION NAME:  FvSDK_StopBenchmark
//
//!   DESCRIPTION: TODO
//!
//! \param [in] session
//!
//! \retval    FV_SUCCESS
//! \retval    FV_ERROR
//!
///////////////////////////////////////////////////////////////////////////////
FVSDK_INTERFACE FvSDK_StopBenchmark(FvSession session);

///////////////////////////////////////////////////////////////////////////////
//
// FUNCTION NAME:  FvSDK_ReadBenchmarkData
//
//!   DESCRIPTION: TODO
//!
//! \param [in] session
//! \param [in,out] pSamples
//! \param [in] sampleCount
//!
//! \retval    FV_SUCCESS
//! \retval    FV_ERROR
//!
///////////////////////////////////////////////////////////////////////////////
FVSDK_INTERFACE FvSDK_ReadBenchmarkData(FvSession session, Samples* pSamples, unsigned int numSamples);

///////////////////////////////////////////////////////////////////////////////
//
// FUNCTION NAME:  FvSDK_StopSession
//
//!   DESCRIPTION: Stops metrics capturing session.
//!   This must be called in pairs with FvSDK_StopSession.
//!
//! \param [in] FvSession
//!
//! \retval    FV_SUCCESS
//! \retval    FV_INVALID_SESSION
//!
///////////////////////////////////////////////////////////////////////////////
FVSDK_INTERFACE FvSDK_StopSession(FvSession);

///////////////////////////////////////////////////////////////////////////////
//
// FUNCTION NAME:  FvSDK_Shutdown
//
//!   DESCRIPTION: Destroy any session specific data. After calling
//!     FvSDK_DestroySession FvSession handle becomes invalid. Do not call this
//!     function while application is still executing FvSDK_SampleData
//!
//! \param [in] FvSession
//!
//! \retval    FV_SUCCESS
//! \retval    FV_INVALID_SESSION
//!
///////////////////////////////////////////////////////////////////////////////
FVSDK_INTERFACE FvSDK_DestroySession(FvSession);

///////////////////////////////////////////////////////////////////////////////
//
// FUNCTION NAME:  FvSDK_Shutdown
//
//!   DESCRIPTION: Unloads FvSDK library. Do not call this function while 
//!         while application is still executing FvSDK_SampleData
//!
//! \retval    FV_SUCCESS
//!
///////////////////////////////////////////////////////////////////////////////
FVSDK_INTERFACE FvSDK_Shutdown();