IScanningTunerEx::PerformExhaustiveScan

 
Microsoft DirectShow 9.0

IScanningTunerEx::PerformExhaustiveScan

This topic applies to Windows Vista.

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

Syntax

  HRESULT PerformExhaustiveScan(
    long 
  dwLowerFreq
  ,  
    long 
  dwHigherFreq
  ,
    VARIANT_BOOL 
  bFineTune
  ,
    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 Values

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

Remarks

This method is asynchronous.

Requirements

Header: Include Tuner.h.

See Also