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 |