IScanningTunerEx::GetTunerStatus method (tuner.h)

Article
12/05/2018

[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 GetTunerStatus method returns the current status of the most recent call to PerformExhaustiveScan.

Syntax

HRESULT GetTunerStatus(
  [out] long *SecondsLeft,
  [out] long *CurrentLockType,
  [out] long *AutoDetect,
  [out] long *CurrentFreq
);

Parameters

[out] SecondsLeft

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

[out] CurrentLockType

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

[out] AutoDetect

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

[out] CurrentFreq

Receives the frequency that was most recently scanned.

Return value

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

Requirement	Value
Target Platform	Windows
Header	tuner.h

Share via