IAMStats::GetValueByName method (control.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The GetValueByName method retrieves a statistic, by name.
Syntax
HRESULT GetValueByName(
[in] BSTR szName,
[out] long *lIndex,
[out] long *lCount,
[out] double *dLast,
[out] double *dAverage,
[out] double *dStdDev,
[out] double *dMin,
[out] double *dMax
);
Parameters
[in] szName
Specifies the name of the statistic.
[out] lIndex
Pointer to a variable that receives the index of this statistic.
[out] lCount
Pointer to a variable that receives the number of values that were recorded.
[out] dLast
Pointer to a variable that receives the most recent value that was recorded.
[out] dAverage
Pointer to a variable that receives the average value.
[out] dStdDev
Pointer to a variable that receives the standard deviation of the values. If the count is less than two, the standard deviation is zero.
[out] dMin
Pointer to a variable that receives the minimum value that was recorded.
[out] dMax
Pointer to a variable that receives the maximum value that was recorded.
Return value
Returns an HRESULT value. Possible values include the following.
| Return code | Description |
|---|---|
|
Success. |
|
No match for this name. |
|
NULL pointer argument. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | control.h (include Dshow.h) |
| Library | Strmiids.lib |