IMediaFilter::GetState 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
GetState 方法检索筛选器的状态 (运行、停止或暂停) 。
语法
HRESULT GetState(
[in] DWORD dwMilliSecsTimeout,
[out] FILTER_STATE *State
);
参数
[in] dwMilliSecsTimeout
超时间隔(以毫秒为单位)。 若要无限期阻止,请使用 VALUE INFINITE。
[out] State
接收 FILTER_STATE 枚举类型的成员,指示筛选器的状态。
返回值
返回 HRESULT 值。 可能的值包括下表中显示的值。
返回代码 | 说明 |
---|---|
|
成功。 |
|
NULL 指针参数。 |
|
中间状态。 |
|
筛选器处于活动状态,但无法传递数据。 |
备注
状态转换可以是异步的。 如果筛选器正在转换到新状态,并且方法在转换完成之前超时,则该方法将返回 VFW_S_STATE_INTERMEDIATE。
如果筛选器由于某种原因无法传送数据,则返回 VFW_S_CANT_CUE。 实时捕获筛选器在暂停时返回此值,因为它们不会提供处于暂停状态的数据。
有关详细信息,请参阅 Filter Graph 中的数据流。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | strmif.h (包括 Dshow.h) |
Library | Strmiids.lib |