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