IAMStats 介面 (control.h)

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

介面 IAMStats 會從 Filter Graph 管理員擷取效能數據。 篩選條件可以使用這個介面來記錄效能數據。

篩選開發人員：如同所有 Filter Graph Manager 介面，篩選條件不得在此介面上保存參考計數，否則會導致迴圈參考計數。 如需詳細資訊，請參閱 IBaseFilter：：JoinFilterGraph。

繼承

IAMStats 介面繼承自 IDispatch 介面。 IAMStats 也有下列類型的成員：

方法

IAMStats 介面具有這些方法。

IAMStats：：AddValue AddValue 方法會記錄新的值。
IAMStats：：get_Count get_Count方法會擷取統計數據數目。
IAMStats：：GetIndex GetIndex 方法會擷取具名統計數據的索引，或建立新的統計數據。
IAMStats：：GetValueByIndex GetValueByIndex 方法會依索引擷取統計數據。
IAMStats：：GetValueByName GetValueByName 方法會依名稱擷取統計數據。
IAMStats：：Reset Reset 方法會將所有統計數據重設為零。

備註

每個統計數據都是以名稱和索引來定義。 使用 GetIndex 方法可從名稱尋找索引。 值一律為 雙精度浮 點數。 預先定義下列統計數據。

名稱	描述
RenderFile	測量每次呼叫 IGraphBuilder：：RenderFile 所花費的時間。
ConnectDirectInternal	測量連接兩個篩選所花費的時間。
建置對應器快取	測量 篩選對應程式 物件) (所註冊篩選條件的相關信息所花費的時間。
進程 類別目錄名稱	測量在特定類別中快取篩選資訊所花費的時間，其中 CategoryName 是篩選類別的易記名稱。 (請參閱 篩選類別.)

 

針對這些統計數據，這些值代表毫秒的時間。

規格需求

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

另請參閱

IDispatch