ITuner

ITuner インターフェイスは、Microsoft BDA Network Provider フィルターに実装されています。

このインターフェイスのインターフェイス識別子 (IID) を宣言するには、__uuidof 演算子を使用します: __uuidof(ITuner)。

get_TuningSpace メソッドは、現在 Network Provider に対して有効なチューニングスペースを取得します。

メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

put_TuningSpace メソッドは、Network Provider のチューニングスペースを設定します。

メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

EnumTuningSpaces メソッドは、この実装が優先するチューニングスペースのコレクションを作成します。

成功した場合は S_OK を返します。メソッドが失敗した場合、エラー情報は標準の COM IErrorInfo インターフェイスを使用して取得できます。

このリストは、この実装に対して互換性のあるチューニングスペースのサブセットです。

get_TuneRequest メソッドは、現在 Network Provider に対して有効なチューン要求を取得します。

メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

チューン要求が Tuner に送信されると、その Components コレクションが設定されます。プログラムへのチューニング後に get_TuneRequest を呼び出すことで、アプリケーションはそのプログラムに対して現在利用可能なコンポーネントを判別でき、コレクション内の Component オブジェクトに対して IComponent::put_Status メソッドを使用して、それらを有効化または無効化できます。たとえば、アプリケーションが英語のオーディオストリームからスペイン語のオーディオストリームに切り替えるのはこの方法によります。

put_TuneRequest メソッドは、現在 Network Provider に対して有効なチューン要求を設定します。

メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

このメソッドを呼び出すと、チューン要求のプロパティに基づいてチューニング操作が開始されます。チューニング操作は非同期に試行される場合があります。

Validate メソッドは、チューン要求を実行できることを示す値を返します。

メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

Network Provider は、まず優先するチューン要求インターフェイスに対してクエリを行います。いずれかが見つかった場合、Network Provider はそのチューン要求が実行可能であることを検証します。いずれも利用できない場合は、次に優先するチューニングスペースインターフェイスに対してクエリを行います。いずれかが見つかった場合、Network Provider は指定されたチューニングスペースに対して自身を構成できることを検証します。

get_PreferredComponentTypes メソッドは、既定のコンポーネント選択に使用される ComponentType オブジェクトのコレクションを取得します。

メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

プログラムが終了すると、新しいストリームコンポーネントのセットが利用可能になる場合があります。そのため、その時点でチューナーは優先コンポーネントタイプのリストを自動的に調べ、そのリストに基づいてコンポーネントを選択します。リストが利用できない場合、チューナーは他の要因に基づいて選択を行います。アプリケーションは、現在のリストを調べるためにこのメソッドを呼び出すだけです。

put_PreferredComponentTypes メソッドは、既定のコンポーネント選択に使用される ComponentType オブジェクトのコレクションを設定します。

メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

アプリケーションは、空の ComponentTypes コレクションをインスタンス化して内容を埋め、put_PreferredComponentTypes を使用して Tuner に送信することで、優先コンポーネントタイプのリストを作成します。

get_SignalStrength メソッドは、Network Provider 固有の信号強度メトリックを取得します。

メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

値 -1 は判別不能、0 は未チューニング、最大値は最良の信号を意味します。デジタルチューナーの場合、この値には FEC のビット誤り率 (BER) も反映されます。

TriggerSignalEvents メソッドは、信号の状態が変化したときにチューナーがイベントを発生させることを有効にします。

メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

タイムアウト間隔が満了するまでに信号状態が変化しなかった場合、チューナーはタイムアウト間隔の終了時に信号状態変化イベントを発生させます。呼び出し元が間隔として INFINITE を指定した場合、チューナーは信号状態が変化するまでイベントを発生させず、変化が起こるまでに経過する時間の長さには関係しません。値 0 を指定すると、信号状態が変化したかどうかに関係なく、信号状態変化イベントが直ちに発生します。

TriggerSignalEvents の各呼び出しでは、イベントを 1 回だけ発生させることができます。一連の信号状態変化に応じてイベントを複数回発生させるには、TriggerSignalEvents を連続して呼び出す必要があります。

複数のイベントシンクオブジェクトが、信号状態が変化したときに発生するイベントをチューナーが発生させるのを待機できます。詳細については、IBroadcastEvent Interface を参照してください。