IAMStats::GetValueByName

  • Article
 
Microsoft DirectShow 9.0

IAMStats::GetValueByName

The GetValueByName method retrieves a statistic, by name.

Syntax

  HRESULT GetValueByName(
  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.

Requirements

Header: Declared in Control.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also