Edit

Share via

IMFCameraControlNotify::OnChange method (mfidl.h)

  • Article

Raised when a camera control value is changed.

Syntax

void OnChange(
  REFGUID controlSet,
  UINT32  id
);

Parameters

controlSet

A GUID specifying the camera control set to which the changed control belongs.

id

The ID of the changed control within the control set.

Return value

None

Remarks

The control for which the OnChange event is invoked is specified by calling IMFCameraControlMonitor::AddControlSubscription. 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. If a changed control is outside of those sets, then the OnChange callback will have the value KSPROPERTYSETID_ANYCAMERACONTROL as its controlSet parameter, but for the explicitly supported property sets, the controlSet GUID will still return the supported property set GUID, not KSPROPERTYSETID_ANYCAMERACONTROL. The returned id parameter in all cases will be the control ID of the altered control.

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