IAMCameraControl::Set method (strmif.h)

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The Set method sets a specified property on the camera.

Syntax

HRESULT Set(
  [in] long Property,
  [in] long lValue,
  [in] long Flags
);

Parameters

[in] Property

Specifies the property to set, as a value from the CameraControlProperty enumeration.

[in] lValue

Specifies the new value of the property.

[in] Flags

Specifies the desired control setting, as a member of the CameraControlFlags enumeration.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

If the Flags parameter is CameraControl_Flags_Auto, the method ignores the lValue parameter, as long as it's between the minimum and maximum values of the property.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header strmif.h (include Dshow.h)
Library Strmiids.lib

See also

Configure the Video Quality

Error and Success Codes

IAMCameraControl Interface

IAMCameraControl::Get