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 |
---|---|
|
No scan is currently in progress. |
|
Invalid frequency argument (for example, 0 dwLowerFrequency or dwHigherFreq value or dwLowerFrequency >= dwHigherFreq). |
|
Success. |
Remarks
This method is asynchronous.
Requirements
Requirement | Value |
---|---|
Target Platform | Windows |
Header | tuner.h |