IAMCameraControl::Set method (strmif.h)

Article
02/22/2024

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

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