ITuneRequest

ITuneRequest インターフェイスは、すべてのチューン要求の基底インターフェイスです。

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

get_TuningSpace メソッドは、このチューン要求の作成に使用されたチューニングスペースを取得します。

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

既定のロケーターおよび既定の推奨コンポーネントタイプを取得するには、まずチューニングスペースにアクセスする必要があります。

get_Components メソッドは、このチューン要求に含まれるコンポーネントを取得します。

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

チューン要求は常にコンポーネントのコレクションを保持しますが、このコレクションは空の場合もあります。コンポーネント情報がトランスポートストリームのテーブル内に存在する場合、Guide Store ローダーは TIF からその情報を取得し、チューン要求の作成時にそれを組み込むことができます。

メソッドが成功した場合、IComponents インターフェイスには未解放の参照カウントが残ります。呼び出し側はこのインターフェイスを解放する必要があります。

チューン要求が Network Provider フィルターに送信されると、Network Provider はチューン要求内のコンポーネントリストを更新します。更新されたコンポーネントリストを取得するには、Network Provider に対して ITuner::get_TuneRequest を呼び出し、返されたチューン要求に対して get_Components を呼び出します。(Network Provider に送信された元のチューン要求は更新されません。これは、Network Provider がチューン要求の内部コピーを作成するためです。したがって、更新されたコンポーネントリストを取得するには get_TuneRequest を呼び出す必要があります。)

Clone メソッドは、このチューン要求の新しいコピーを返します。

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

このメソッドはオブジェクトの「ディープコピー」を実行します。つまり、Components や LanguageComponentType オブジェクトなどを含む、すべてのサブオブジェクトもコピーします。

get_Locator メソッドは、要求された放送に関連付けられた ILocator オブジェクトを取得するために Network Provider から呼び出されます。

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

put_Locator メソッドは、要求された放送に関連付けられた ILocator オブジェクトを設定するために Network Provider から呼び出されます。

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