共用方式為

IAMStats：：GetValueByIndex 方法 (control.h)

  • 發行項

[與此頁面相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式代碼盡可能重寫為使用新的 API。

方法會 GetValueByIndex 依索引擷取統計數據。

語法

HRESULT GetValueByIndex(
  [in]  long   lIndex,
  [out] BSTR   *szName,
  [out] long   *lCount,
  [out] double *dLast,
  [out] double *dAverage,
  [out] double *dStdDev,
  [out] double *dMin,
  [out] double *dMax
);

參數

[in] lIndex

統計數據以零起始的索引。

[out] szName

接收統計數據名稱之變數的指標。

[out] lCount

接收所記錄值的變數指標。

[out] dLast

接收最近記錄值的變數指標。

[out] dAverage

接收平均值之變數的指標。

[out] dStdDev

接收值標準偏差之變數的指標。 如果計數小於 2，則標準偏差為零。

[out] dMin

接收所記錄最小值之變數的指標。

[out] dMax

接收所記錄最大值之變數的指標。

傳回值

傳回 HRESULT 值。 可能的值如下。

傳回碼 描述
S_OK
 成功。
E_INVALIDARG
 超出範圍的索引。
E_OUTOFMEMORY
 記憶體不足。
E_POINTER
 NULL 指標自變數。

備註

呼叫端必須藉由呼叫 SysFreeString 函式，釋放 szName 中傳回的字串。

若要取得統計數據數目，請呼叫 IAMStats：：GetIndex。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 control.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

IAMStats 介面