ITuneRequestInfo::CreateComponentList
CreateComponentList メソッドは、チューニング要求の新しい Components コレクションを作成し、レシーバがサービスにチューニングした後、すべてのネットワーク固有のデータを設定する。
構文
HRESULT CreateComponentList(
ITuneRequest* pCurrentRequest
);
パラメータ
pCurrentRequest
[in] チューニング要求の ITuneRequest インターフェイスへのポインタ。
戻り値
メソッドは、HRESULT を返す。可能な値は次の一覧のとおりである。
戻りコード | 説明 |
S_OK | メソッドは成功し、新しいデータが追加された。 |
S_FALSE | メソッドは成功したが、新しいデータは追加されていない。 |
E_FAIL | データを取得できなかった。 |
注意
ネットワーク プロバイダは正しいトランスポート ストリームを取得した後、TIF にコンポーネント データを設定するように指示する。チューニング要求にコンポーネント リストが含まれていない場合、ネットワーク プロバイダはこのメソッドを呼び出して、関連するトランスポート ストリーム テーブルに基づいてコンポーネント リストを作成するように TIF に指示する。一般的に、コンポーネントには 1 つまたは複数のオーディオ ストリーム、ビデオ、データ、およびテキストが含まれる。各コンポーネントにはコンポーネント タイプがあり、MPEG2 チューニング空間については、各コンポーネントに PID および pcrPID が関連付けられている。理想的なのは、ガイド ストア ローダーがチューニング要求を作成するときに、利用可能なすべてのコンポーネント情報を含めることである。
TIF が既存のコンポーネント リストを変更できるようにするには、ITuneRequestInfo::GetComponentData メソッドを使う。S_FALSE は何も変更されていなかったことを示す。
参照