IAMStats 接口 (control.h)
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 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 方法从名称中查找索引。 值始终为 double 类型。 以下统计信息是预定义的。
| 名称 | 说明 |
|---|---|
| RenderFile | 度量每次调用 IGraphBuilder：：RenderFile 所花费的时间。 |
| ConnectDirectInternal | 测量连接两个筛选器所需的时间。 |
| 生成映射器缓存 | 测量缓存有关 筛选器映射器 对象) 使用的已注册筛选器的信息 (所花费的时间。 |
| 进程类别 类别名称 | 度量缓存特定类别中有关筛选器的信息所花费的时间，其中 CategoryName 是筛选器类别的友好名称。 (请参阅 筛选器类别。) |
对于其中每个统计信息，这些值表示以毫秒为单位的时间。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | control.h (包括 Dshow.h) |