Share via


IScanningTunerEx::PerformExhaustiveScan method (tuner.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

This topic applies to Windows Vista and later.

The PerformExhaustiveScan method scans a range of frequencies until the tuner locks onto a signal.

Syntax

HRESULT PerformExhaustiveScan(
  [in] long         dwLowerFreq,
  [in] long         dwHigherFreq,
  [in] VARIANT_BOOL bFineTune,
  [in] HEVENT       hEvent
);

Parameters

[in] dwLowerFreq

Lowest frequency in the range of frequencies to scan. A value of -1 specifies the minimum frequency as determined by the device.

[in] dwHigherFreq

Highest frequency in the range of frequencies to scan. A value of -1 specifies the maximum frequency as determined by the device.

[in] bFineTune

Specifies whether the tuner performs fine tuning. When the tuner locks onto a frequency, if this parameter is VARIANT_TRUE, the tuner does fine tuning to find the best possible signal around that frequency.

[in] hEvent

Handle to an event created by the application. When the tuner locks onto a signal, it signals this event.

Return value

Returns an HRESULT value. Possible values include the following.

Return value Description
S_FALSE
No scan is currently in progress.
E_INVALIDARG
Invalid frequency argument (for example, 0 dwLowerFrequency or dwHigherFreq value or dwLowerFrequency >= dwHigherFreq).
S_OK
Success.

Remarks

This method is asynchronous.

Requirements

Requirement Value
Target Platform Windows
Header tuner.h

See also

IScanningTunerEx Interface