IMFCameraControlMonitor::AddControlSubscription 方法 (mfidl.h)
将相机控件添加到将引发 IMFCameraControlNotify::OnChange 通知的控件列表中。
语法
HRESULT AddControlSubscription(
GUID controlSet,
UINT32 id
);
参数
controlSet
添加的控件所属的相机控件集的 GUID。
id
控件集中控件的 ID。
返回值
包括以下内容的 HRESULT:
值 | 说明 |
---|---|
S_OK | 成功 |
MF_E_INVALIDREQUEST | 相机控制监视器处于运行或关闭状态。 |
MF_E_INVALIDARG | 为 controlSet 提供的值无效。 有关更多信息,请参见备注。 |
注解
在调用 Start 之后、调用 Stop 之前或调用 Shutdown 之后尝试添加或删除订阅将导致错误。
显式支持的控件包括 PROPSETID_VIDCAP_VIDEOPROCAMP 和 PROPSETID_VIDCAP_CAMERACONTROL下的属性,以及 KSPROPERTYSETID_ExtendedCameraControl。 如果使用 KSPROPERTYSETID_ANYCAMERACONTROL 作为 controlSet 参数调用 AddControlSubscription,则创建的订阅将引发任何控件更改的回调,即使是之前列出的属性集之外的更改。
指定除 KSPROPERTYSETID_ANYCAMERACONTROL、PROPSETID_VIDCAP_VIDEOPROCAMP、PROPSETID_VIDCAP_CAMERACONTROL 或 KSPROPERTYSETID_ExtendedCameraControl 以外的值将导致错误。
若要查看实现此方法的代码示例,请参阅 IMFCameraControlNotify。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 11内部版本 22621 |
最低受支持的服务器 | Windows 11内部版本 22621 |
标头 | mfidl.h |
Library | mfsensorgroup.lib |
DLL | mfsensorgroup.dll |