IScanningTunerEx::PerformExhaustiveScan Method

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

See Also

IScanningTunerEx Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008