IScanningTunerEx::PerformExhaustiveScan Method

Article
01/07/2009

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

dwLowerFreq [in]
Lowest frequency in the range of frequencies to scan.
dwHigherFreq [in]
Highest frequency in the range of frequencies to scan.
bFineTune [in]
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.
hEvent [in]
Handle to an event created by the application. When the tuner locks onto a signal, it signals this event.

Return Value

When the method succeeds, it returns S_OK. Otherwise it returns an HRESULT error code.

Remarks

This method is asynchronous.

Requirements

Header

Declared in Tuner.h.

Share via