ITuneRequestInfo::GetLocatorData
GetLocatorData メソッドは、指定したチューニング要求について、チャンネルまたはプログラム ロケータ情報を設定する。
構文
HRESULT GetLocatorData(
ITuneRequest* pRequest
);
パラメータ
pRequest
[in] チューニング要求の ITuneRequest インターフェイスへのポインタ。
戻り値
メソッドは、HRESULT を返す。可能な値は次の一覧のとおりである。
| 戻りコード | 説明 |
| S_OK | メソッドは成功し、新しいロケータ データが追加された。 |
| S_FALSE | メソッドは成功したが、新しいロケータ データは追加されていない。 |
| E_POINTER | Request が有効ではない。 |
注意
TIF がロケータ情報を設定した後、ネットワーク プロバイダはその情報を使ってチューナーおよびデモジュレータを構成する。TIF は常にロケータに関するすべての情報を把握していると想定されている。特定のチューニング要求を特定する方法がわからない場合、TIF はいつでもそのチューニング空間のデフォルトのロケータに戻すことができる。TIF はデフォルトのストリームからテーブルの取得を開始すると同時に、ネットワーク プロバイダに通知し、ネットワーク プロバイダは新しいロケータ データを要求することができる。TIF はロケータ データを設定すると、ネットワーク プロバイダに通知し、ネットワーク プロバイダは新しい情報を使って再度チューニングする。TIF は新しいストリームからテーブルの取得を開始すると、再度ネットワーク プロバイダに通知し、同じ処理を繰り返す。
参照