Share via

IScanningTunerEx::GetTunerStatus

  • Article
 
Microsoft DirectShow 9.0

IScanningTunerEx::GetTunerStatus

This topic applies to Windows Vista.

The GetTunerStatus method returns the current status of the most recent call to PerformExhaustiveScan.

Syntax

  HRESULT GetTunerStatus(
    long *
  SecondsLeft
  ,
    long *
  CurrentLockType
  ,
    long *
  AutoDetect
  ,
    long *
  CurrentFreq

  );

Parameters

SecondsLeft

[out]  Receives the estimated number of seconds remaining for the scan to complete.

CurrentLockType

[out]  Receives a member of the TunerLockType enumeration, indicating how well the tuner locked onto a signal.

AutoDetect

[out]  Receives a Boolean value. If the value is TRUE, the tuner is in auto-detect mode.

CurrentFreq

[out]  Receives the frequency that was most recently scanned.

Return Values

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

Remarks

While the scan is in progress, the application can use this method to estimate the total time required for the scan to complete. When the tuner locks onto a frequency and sets the application's event handle, the application can use this method to find the locked frequency.

Requirements

Header: Include Tuner.h.

See Also