IAMTuner::SignalPresent

 
Microsoft DirectShow 9.0

IAMTuner::SignalPresent

The SignalPresent method retrieves the strength of the signal on a given channel.

Syntax

  HRESULT SignalPresent(
  long *plSignalStrength
);

Parameters

plSignalStrength

[out] Pointer to a variable that receives a value indicating whether a signal is present on the current channel. Can be one of the following values.

Value Description
AMTUNER_HASNOSIGNALSTRENGTH -1
AMTUNER_NOSIGNAL 0
AMTUNER_SIGNALPRESENT 1

A value of AMTUNER_HASNOSIGNALSTRENGTH means the signal strength cannot be determined at this time.

Return Values

Returns an HRESULT value.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also