Microsoft DirectX 8.0

ITunerEvents インターフェイス

このインターフェイスは、標準 COM IConnectionPoint インターフェイスである。アプリケーションにこのインターフェイスを実装すると、新しい周波数またはチャンネルにチューニングするたびに、チューナー オブジェクトからイベント通知を受け取ることができる。このインターフェイスは TuneRequest オブジェクトを返し、新しいチャンネルまたは周波数で実際に利用可能なサブストリームが、その Components コレクションに反映されている。

ITunerEvents::OnTune

ITunerEvents インターフェイス

チューナー フィルタが新しい周波数にチューニングしたことをアプリケーションに知らせる。

構文

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

パラメータ

Request
[in] TuneRequest オブジェクトを受け取る ITuneRequest インターフェイス ポインタのアドレス。このオブジェクトの Components コレクションに、新しいチャンネルまたは周波数で利用可能なサブストリームが反映されている。
Strength
[in] 新しいチャンネルまたは周波数の信号強度を表す Long 型変数へのポインタ。

戻り値

成功した場合は、S_OK を返す。失敗した場合は、標準の IErrorInfo インターフェイスを使ってエラー情報を取得できる。