ホーム › Media.DirectShow.Tv › ITuneRequestInfo

ITuneRequestInfo

COM

📘 Microsoft Learn (日本語) · English

IIDa3b152df-7a90-4218-ac54-9830bee8c0b6継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

ITuneRequestInfo インターフェイスは BDA MPEG2 Transport Information Filter (TIF) に実装され、Network Provider によって使用されます。

解説(Remarks)

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

メソッド 7

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetLocatorData(ITuneRequest* Request)

GetLocatorData メソッドは、指定されたチューン要求に対してチャンネルまたは番組のロケーター情報を設定します。

Request

ITuneRequest*

チューン要求上の ITuneRequest インターフェイスへのポインター。

戻り値

このメソッドは HRESULT を返します。とり得る値には次の表に示すものが含まれます。

戻り値	説明
S_OK	メソッドが成功し、新しいロケーターデータが取得されました。
S_FALSE	メソッドは成功しましたが、新しいロケーターデータは取得されませんでした。
E_POINTER	Request が有効ではありません。

解説(Remarks)

TIF がロケーター情報を設定した後、Network Provider はその情報を使用してチューナーと復調器を構成します。TIF はロケーターに関するすべてを常に把握していることが期待されます。特定のチューン要求の位置を特定する方法がわからない場合は、常にチューニングスペースの既定のロケーターにフォールバックできます。TIF が既定のストリームからテーブルの取得を開始すると、Network Provider にシグナルを送り、Network Provider は新しいロケーターデータを要求します。TIF がそれを設定すると Network Provider にシグナルを送り、Network Provider は新しい情報を使用して再度チューニングします。TIF が新しいストリームでテーブルの取得を開始すると、再び Network Provider にシグナルを送り、この処理が繰り返されます。

vtbl 4 HRESULT GetComponentData(ITuneRequest* CurrentRequest)

GetComponentData メソッドは、指定されたチューン要求上の既存の Components コレクションに対して、ネットワーク固有のコンポーネントデータをすべて設定します。

CurrentRequest

ITuneRequest*

チューン要求上の ITuneRequest インターフェイスへのポインター。

戻り値

このメソッドは HRESULT を返します。とり得る値には次の表に示すものが含まれます。

戻り値	説明
S_OK	メソッドが成功し、新しいデータが追加されました。
S_FALSE	メソッドは成功しましたが、新しいデータは追加されませんでした。

解説(Remarks)

Network Provider は、チューナーが指定されたサービスにチューニングした後、このメソッドを呼び出します。

vtbl 5 HRESULT CreateComponentList(ITuneRequest* CurrentRequest)

CreateComponentList メソッドは、チューン要求に対して新しい Components コレクションを作成し、受信機がサービスにチューニングした後に、ネットワーク固有のデータをすべて設定します。

CurrentRequest

ITuneRequest*

チューン要求上の ITuneRequest インターフェイスへのポインター。

戻り値

このメソッドは HRESULT を返します。とり得る値には次の表に示すものが含まれます。

戻り値	説明
S_OK	メソッドが成功し、新しいデータが追加されました。
S_FALSE	メソッドは成功しましたが、新しいデータは追加されませんでした。
E_FAIL	データを取得できませんでした。

解説(Remarks)

Network Provider は、正しい transport stream を取得した後、TIF にコンポーネントデータの設定を要求します。チューン要求にコンポーネントリストがまだ存在しない場合、Network Provider はこのメソッドを呼び出し、関連する transport stream テーブルに基づいてリストを作成するよう TIF に要求します。通常、コンポーネントには 1 つ以上のオーディオストリーム、ビデオ、データ、テキストが含まれます。各コンポーネントにはコンポーネントタイプがあり、MPEG2 チューニングスペースでは各コンポーネントに関連付けられた PID と pcrPID があります。理想的には、Guide Store Loader がチューン要求を作成する際に、利用可能なすべてのコンポーネント情報を含めます。

ITuneRequestInfo::GetComponentData メソッドは、既存のコンポーネントリストを TIF が変更できるようにするために使用されます。S_FALSE は何も変更されなかったことを示します。

vtbl 6 HRESULT GetNextProgram(ITuneRequest* CurrentRequest, ITuneRequest** TuneRequest)

GetNextProgram メソッドは、次のサービスに対するチャンネルまたは番組のロケーター情報を持つ新しいチューン要求を作成します。

CurrentRequest	ITuneRequest*	in	現在の要求の ITuneRequest インターフェイスを指定します。
TuneRequest	ITuneRequest**	out	transport stream 上の次のサービスに対するチューン要求を受け取る変数へのポインター。

戻り値

このメソッドは HRESULT を返します。とり得る値には次の表に示すものが含まれます。

戻り値	説明
S_OK	メソッドが成功しました。
E_POINTER	CurrentRequest が有効でないか、TuneRequest が NULL です。

解説(Remarks)

このメソッドは、transport stream 上で利用可能なサービスを列挙するために、カスタムの Guide Store Loader によって使用される場合があります。

vtbl 7 HRESULT GetPreviousProgram(ITuneRequest* CurrentRequest, ITuneRequest** TuneRequest)

GetPreviousProgram メソッドは、前のサービスに対するチャンネルまたは番組のロケーター情報を持つ新しいチューン要求を作成します。

CurrentRequest	ITuneRequest*	in	現在の要求を指定します。
TuneRequest	ITuneRequest**	out	現在の transport stream 内の前のサービスに対するチューン要求を受け取る変数へのポインター。

戻り値

このメソッドは HRESULT を返します。とり得る値には次の表に示すものが含まれます。

戻り値	説明
S_OK	メソッドが成功しました。
E_POINTER	CurrentRequest が有効でないか、TuneRequest が NULL です。

解説(Remarks)

このメソッドは、transport stream 上で利用可能なサービスを列挙するために、カスタムの Guide Store Loader によって使用される場合があります。

vtbl 8 HRESULT GetNextLocator(ITuneRequest* CurrentRequest, ITuneRequest** TuneRequest)

GetNextLocator メソッドは、ネットワーク上の次の transport stream に対するロケーター情報を持つ新しいチューン要求を作成します。

CurrentRequest	ITuneRequest*	in	現在のチューン要求の ITuneRequest インターフェイスを指定します。NULL は最初のストリームの情報を返すことを意味します。
TuneRequest	ITuneRequest**	out	次の transport stream に対するチューン要求を受け取る変数へのポインター。

戻り値

このメソッドは HRESULT を返します。とり得る値には次の表に示すものが含まれます。

戻り値	説明
S_OK	メソッドが成功しました。
E_POINTER	CurrentRequest が有効でないか、TuneRequest が NULL です。

解説(Remarks)

このメソッドは、Network Provider の IScanningTuner::SeekUp および IScanningTuner::SeekDown メソッドによって内部的に使用されるほか、ネットワークをスキャンして EPG 情報を取得する任意の Guide Store Loader にも役立ちます。

現在、このメソッドは DVB-C または DVB-S ネットワークには実装されておらず、E_NOTIMPL を返します。DVB-T には実装されています。

vtbl 9 HRESULT GetPreviousLocator(ITuneRequest* CurrentRequest, ITuneRequest** TuneRequest)

GetPreviousLocator メソッドは、前の transport stream に対するロケーター情報を持つ新しいチューン要求を作成します。

CurrentRequest	ITuneRequest*	in	現在の要求を指定します。
TuneRequest	ITuneRequest**	out	ネットワーク内の前の transport stream に対するチューン要求を受け取る変数へのポインター。

戻り値

このメソッドは HRESULT を返します。とり得る値には次の表に示すものが含まれます。

戻り値	説明
S_OK	メソッドが成功しました。
E_POINTER	CurrentRequest が有効でないか、TuneRequest が NULL です。

解説(Remarks)

現在、このメソッドは DVB-C または DVB-S ネットワークには実装されておらず、E_NOTIMPL を返します。DVB-T には実装されています。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

#define global IID_ITuneRequestInfo "{A3B152DF-7A90-4218-AC54-9830BEE8C0B6}"
#usecom global ITuneRequestInfo IID_ITuneRequestInfo "{}"
#comfunc global ITuneRequestInfo_GetLocatorData       3 sptr
#comfunc global ITuneRequestInfo_GetComponentData     4 sptr
#comfunc global ITuneRequestInfo_CreateComponentList  5 sptr
#comfunc global ITuneRequestInfo_GetNextProgram       6 sptr,sptr
#comfunc global ITuneRequestInfo_GetPreviousProgram   7 sptr,sptr
#comfunc global ITuneRequestInfo_GetNextLocator       8 sptr,sptr
#comfunc global ITuneRequestInfo_GetPreviousLocator   9 sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。