次の方法で共有

IGuideData::GetGuideProgramIDs

  • [アーティクル]

GetGuideProgramIDs メソッドは、すべてのトランスポート ストリームに格納されているすべてのプログラムの一意の識別子のリストを返す。

構文

  HRESULT GetGuideProgramIDs(
  IEnumVARIANT**  ppEnumPrograms
);

パラメータ

ppEnumPrograms

[out]  IEnumVARIANT インターフェイスへのポインタを受け取る変数のアドレス。このインターフェイスを使ってコレクションを列挙する。呼び出し元はそのインターフェイスを解放しなければならない。

戻り値

メソッドは、HRESULT を返す。可能な値は次の一覧のとおりである。

戻りコード 説明
S_OK メソッドが成功した。

注意

TIF がトランスポート ストリームの PSI テーブルからプログラム情報を受け取っていない場合、このメソッドは失敗する。クライアントは、IGuideDataEvent インターフェイスを実装し、IGuideDataEvent::ProgramChanged イベントが発行されるのを待つ必要がある。

コレクションの各 VARIANT 型は、多重化されたプログラム内で 1 つのプログラムを一意に識別する BSTR を格納する。プログラムに関する詳細な情報を取得するには、VARIANT を IGuideData::GetProgramProperties メソッドに渡す。

返された IEnumVARIANT インターフェイスはスレッド セーフではない。クライアントは、複数のスレッドからこのインターフェイスを呼び出してはならない。

参照