Microsoft DirectX 8.1 (C++)

IAMStats::GetValueByName

The GetValueByName method retrieves a statistic, by name.

Syntax

HRESULT GetValueByIndex(
  BSTR szName
  long *lIndex
  long *lCount
  double *dLast
  double *dAverage
  double *dStdDev
  double *dMin
  double *dMax
);

Parameters

szName

[in] Specifies the name of the statistic.

lIndex

[out] Pointer to a variable that receives the index of this statistic.

lCount

[out] Pointer to a variable that receives the number of values that were recorded.

dLast

[out] Pointer to a variable that receives the most recent value that was recorded.

dAverage

[out] Pointer to a variable that receives the average value.

dStdDev

[out] Pointer to a variable that receives the standard deviation of the values. If the count is less than two, the standard deviation is zero.

dMin

[out] Pointer to a variable that receives the minimum value that was recorded.

dMax

[out] Pointer to a variable that receives the maximum value that was recorded.

Return Values

Returns an HRESULT value. Possible values include the following.

Return code Description
S_OK Success.
E_INVALIDARG No match for this name.
E_POINTER NULL pointer argument.

See Also