Skip to content

Latest commit

 

History

History
66 lines (54 loc) · 2.42 KB

nf-mfidl-imfcameracontrolnotify-onchange.md

File metadata and controls

66 lines (54 loc) · 2.42 KB
UID tech.root title ms.date targetos description prerelease req.assembly req.construct-type req.ddi-compliance req.dll req.header req.idl req.include-header req.irql req.kmdf-ver req.lib req.max-support req.namespace req.redist req.target-min-winverclnt req.target-min-winversvr req.target-type req.type-library req.umdf-ver req.unicode-ansi topic_type api_type api_location api_name f1_keywords dev_langs helpviewer_keywords
NF:mfidl.IMFCameraControlNotify.OnChange
mf
IMFCameraControlNotify::OnChange
05/02/2022
Windows
Raised when a camera control value is changed.
false
function
mfidl.h
Windows 11 Build 22621
Windows 11 Build 22621
apiref
COM
mfidl.h
IMFCameraControlNotify::OnChange
IMFCameraControlNotify::OnChange
mfidl/IMFCameraControlNotify::OnChange
c++
OnChange

-description

Raised when a camera control value is changed.

-parameters

-param controlSet

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

-param id

The ID of the changed control within the control set.

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

-see-also