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_VIDEOPROCAMPPROPSETID_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