IVMRMonitorConfig：：SetMonitor 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
在多监视器系统上， SetMonitor 方法指定此 VMR 实例应用于视频播放的监视器。
语法
HRESULT SetMonitor(
[in] const VMRGUID *pGUID
);
参数
[in] pGUID
指向标识监视器的 VMRGUID 结构的指针。
返回值
返回 HRESULT 值。 可能的值包括以下值。
| 返回代码 | 说明 |
|---|---|
|
无效的参数。 |
|
NULL 指针参数。 |
|
成功。 |
|
尚未加载分配器-呈现器。 |
注解
在多监视器系统上使用此方法，向 VMR 指定在连接到上游解码器筛选器时应使用哪个 DirectDraw 驱动程序。
VMRGUID 结构的 pGUID 成员必须为 NULL（指示默认 DirectDraw 设备），或等于 VMRGUID 结构的 GUID 成员的地址。 否则，该方法返回E_INVALIDARG。
如果指定的 GUID 不对应于任何监视器，则该方法返回E_INVALIDARG。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP SP1 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | strmif.h (包括 Dshow.h) |
| Library | Strmiids.lib |