IMFCameraControlMonitor::AddControlSubscription 方法 (mfidl.h)
將相機控件新增至 將引發IMFCameraControlNotify::OnChange 通知的控件清單。
語法
HRESULT AddControlSubscription(
GUID controlSet,
UINT32 id
);
參數
controlSet
新增控件所屬相機控制件的 GUID。
id
控件集內的控件標識碼。
傳回值
HRESULT,包括下列專案:
值 | 描述 |
---|---|
S_OK | Success |
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 |
程式庫 | mfsensorgroup.lib |
Dll | mfsensorgroup.dll |