IVMRImagePresenter：:P resentImage 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
在 PresentImage 应显示此视频帧的那一刻，将调用 方法。
语法
HRESULT PresentImage(
[in] DWORD_PTR dwUserID,
[in] VMRPRESENTATIONINFO *lpPresInfo
);
参数
[in] dwUserID
应用程序定义的DWORD_PTR，在多个 VMR 实例与分配器表示器的单个实例一起使用时唯一标识 VMR 的此实例。 请参阅备注
[in] lpPresInfo
指定 VMRPRESENTATIONINFO 结构。
返回值
如果该方法成功，则它会返回 S_OK。 如果该方法失败，则会返回错误代码。
注解
PresentImage 当筛选器处于正在运行或暂停状态时，可以调用 。 StartPresenting 和 StopPresenting 只能在运行状态下调用。 因此，如果图形在运行前暂停， PresentImage 则会在 StartPresenting 之前调用。
应用程序可以通过在单个筛选图或多个筛选图中将 Allocator-Presenter 的单个实例与 VMR 的多个实例结合使用来创建自定义混合效果。 以这种方式使用分配器演示器使应用程序能够混合不同筛选图中的流，或在同一筛选器图中混合不同的流。 如果使用 VMR 的单个实例，请将此值设置为零。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 具有 SP1 的 Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | strmif.h (包括 Dshow.h) |
| Library | Strmiids.lib |