IGuideData::GetServiceProperties
GetServiceProperties メソッドは、指定されたサービスのプロパティを取得する。
構文
HRESULT GetServiceProperties(
ITuneRequest* pTuneRequest,
IEnumGuideDataProperties** ppEnumProperties
);
パラメータ
pTuneRequest
[in] 有効なチューニング要求の ITuneRequest インターフェイスへのポインタ。IGuideData::GetServices メソッドを呼び出して、チューニング要求のリストを取得する。
ppEnumProperties
[out] IEnumGuideDataProperties インターフェイス ポインタを受け取る変数へのポインタ。このインターフェイスを使ってプロパティを列挙する。呼び出し元はそのインターフェイスを解放しなければならない。
戻り値
メソッドは、HRESULT を返す。可能な値は次の一覧のとおりである。
戻りコード | 説明 |
S_OK | メソッドが成功した。 |
注意
返されるコレクションには、次のプロパティが含まれる。
プロパティ | 説明 |
Description.ID | サービスの一意の識別子。 |
Description.Name | チャンネル構成でこのサービスについて使うデフォルトの名前。 |
Provider.Name | サービス プロバイダの名前。 |
Provider.NetworkName | サービスを提供するネットワークの名前。 |
TIF がトランスポート ストリームの PSI テーブルからサービス情報を受け取っていない場合、このメソッドは失敗する。クライアントは、IGuideDataEvent インターフェイスを実装し、IGuideDataEvent::ServiceChanged イベントが発行されるのを待つ必要がある。
参照