IMFCameraControlMonitor::RemoveControlSubscription method (mfidl.h)
Removes a camera control from the list of controls for which IMFCameraControlNotify::OnChange notifications will be raised.
Syntax
HRESULT RemoveControlSubscription(
GUID controlSet,
UINT32 id
);
Parameters
controlSet
The GUID for the camera control set to which the added control belongs.
id
The ID of the control within the control set.
Return value
An HRESULT including the following:
Value | Description |
---|---|
S_OK | Success |
MF_E_INVALIDREQUEST | The camera control monitor is in the running or shutdown state. |
MF_E_INVALIDARG | An invalid value was supplied for controlSet. See Remarks for more information. |
MF_E_NOT_FOUND | No subscription was found for the specified control. |
Remarks
Attempting to add or remove subscriptions after calling Start but before calling Stop, or after calling Shutdown, will result in an error.
The explicitly supported controls include the properties under PROPSETID_VIDCAP_VIDEOPROCAMP and PROPSETID_VIDCAP_CAMERACONTROL, and KSPROPERTYSETID_ExtendedCameraControl. If AddControlSubscription is called with KSPROPERTYSETID_ANYCAMERACONTROL as the controlSet parameter, then the created subscription will provoke callbacks for any control change, even those outside of the previously listed property sets.
Specifying a value other than KSPROPERTYSETID_ANYCAMERACONTROL, PROPSETID_VIDCAP_VIDEOPROCAMP, PROPSETID_VIDCAP_CAMERACONTROL or KSPROPERTYSETID_ExtendedCameraControl will result in an error.
To see a code example that implements this method, see IMFCameraControlNotify.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 11 Build 22621 |
Minimum supported server | Windows 11 Build 22621 |
Header | mfidl.h |
Library | mfsensorgroup.lib |
DLL | mfsensorgroup.dll |