IVMRImagePresenter::StartPresenting 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
在 StartPresenting
视频开始播放之前调用 方法。 分配器-演示者应在此方法中执行任何必要的配置。
语法
HRESULT StartPresenting(
[in] DWORD_PTR dwUserID
);
参数
[in] dwUserID
应用程序定义的 DWORD_PTR Cookie,用于唯一标识 VMR 的此实例,以便在分配器表示器的一个实例与多个 VMR 实例一起使用时使用。
返回值
如果该方法成功,则它会返回 S_OK。 如果该方法失败,则会返回错误代码。
注解
当筛选器处于正在运行或暂停状态时,可以调用 PresentImage。 StartPresenting
和 StopPresenting 只能在运行状态下调用。 因此,如果图形在运行前暂停,则会在 之前StartPresenting
调用 PresentImage。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 具有 SP1 的 Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | strmif.h (包括 Dshow.h) |
Library | Strmiids.lib |