IVMRMonitorConfig：：SetDefaultMonitor 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
SetDefaultMonitor方法指定 VMR 的所有未来实例应用于视频播放的默认监视器。
语法
HRESULT SetDefaultMonitor(
[in] const VMRGUID *pGUID
);
参数
[in] pGUID
指向标识监视器的 VMRGUID 结构的指针。
返回值
返回 HRESULT 值。 可能的值包括以下值。
| 返回代码 | 说明 |
|---|---|
|
无法将指定的监视器设置为默认监视器。 |
|
无效的参数。 指定的监视器不存在，或者 pGUID 参数的格式不正确。 |
|
NULL 指针参数。 |
|
成功。 |
|
尚未加载分配器-呈现器。 |
备注
在多监视器系统上使用此方法，向 VMR 指定连接到上游筛选器时要使用的默认 DirectDraw 设备。 可通过 SetMonitor 方法替代特定连接的默认 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 |