IAMCameraControl::GetRange 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 GetRange method gets the range and default value of a specified camera property.

Syntax

HRESULT GetRange(
  [in]  long Property,
  [out] long *pMin,
  [out] long *pMax,
  [out] long *pSteppingDelta,
  [out] long *pDefault,
  [out] long *pCapsFlags
);

Parameters

[in] Property

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

[out] pMin

Receives the minimum value of the property.

[out] pMax

Receives the maximum value of the property.

[out] pSteppingDelta

Receives the step size for the property. The step size is the smallest increment by which the property can change.

[out] pDefault

Receives the default value of the property.

[out] pCapsFlags

Receives one or more members of the CameraControlFlags enumeration, indicating whether the property is controlled automatically, manually, or both.

Return value

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

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