Microsoft DirectX 8.0

ITunerEvents Interface

This is a standard COM IConnectionPoint interface. Implement this interface in your application to receive event notifications from the Tuner object whenever it tunes to a new frequency or channel. This provides a way to receive a TuneRequest object with its components collection updated to reflect the substreams actually available on the new channel or frequency.

ITunerEvents::OnTune

ITunerEvents Interface

Informs an application when the tuner filter tunes to a new frequency.

Syntax

  HRESULT OnTune(
  ITuneRequest** Request,
    long* Strength
    );

Parameters

Request
[in] Address of an ITuneRequest interface pointer that will receive the TuneRequest object whose Components collection has been filled in to reflect the substreams available on the new channel or frequency.
Strength
[in] Pointer to a variable of type long representing the signal strength of the new channel or frequency.

Return Value

Returns S_OK if successful. If the method fails, error information can be retrieved using the standard COM IErrorInfo interface.
-->