ITuner::TriggerSignalEvents

 
Microsoft DirectShow 9.0

ITuner::TriggerSignalEvents

The TriggerSignalEvents method enables the tuner to raise an event when the status of the signal changes.

Syntax

  HRESULT TriggerSignalEvents(
  long  Interval
);

Parameters

Interval

[in]  Specifies the time-out interval in milliseconds.

Return Values

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

Remarks

If the signal status does not change by the time that the time-out interval expires, the tuner raises the signal-status-change event at the end of the time-out interval. If the caller specifies the interval to be INFINITE, the tuner does not raise the event until the signal status changes, regardless of how much time elapses before the change occurs. Specifying a value of 0 raises the signal-status-change event immediately, regardless of whether the signal status has changed.

Each call to TriggerSignalEvents enables the event to be raised only one time. To raise the event multiple times in response to a series of signal-status changes requires a succession of calls to TriggerSignalEvents.

Multiple event sink objects can wait for the tuner to raise an event that occurs when the signal status changes. For more information, see IBroadcastEvent Interface.

Requirements

Header: Include Bdaiface.h.

See Also