IDVB_EIT
COM公式ドキュメント
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
メソッド 21
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| pSectionList | ISectionList* | in | セクションデータを格納する SectionList オブジェクトの ISectionList インターフェイスへのポインター。 |
| pMPEGData | IMpeg2Data* | in | MPEG-2 Sections and Tables フィルターの IMpeg2Data インターフェイスへのポインター。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれます。
| リターンコード | 説明 |
|---|---|
| 引数が無効です。 | |
| オブジェクトはすでに初期化されています。 | |
| メソッドが成功しました。 |
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| pbVal | BYTE* | out | version_number フィールドを受け取る変数へのポインター。 |
戻り値
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| pwVal | WORD* | out | service_id フィールドを受け取る変数へのポインター。 |
戻り値
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| pwVal | WORD* | out | transport_stream_id フィールドを受け取る変数へのポインター。この値は、多重化 (multiplex) 内の他の transport stream からこの transport stream を識別します。 |
戻り値
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| pwVal | WORD* | out | original_network_id フィールドを受け取る変数へのポインター。この値は、配信元の delivery system の network_id を識別します。 |
戻り値
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| pbVal | BYTE* | out | last_section_number フィールドを受け取る変数へのポインター。 |
戻り値
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| pbVal | BYTE* | out | last_table_id フィールドを受け取る変数へのポインター。 |
戻り値
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| pdwVal | DWORD* | out | レコード数を受け取る変数へのポインター。 |
戻り値
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| dwRecordIndex | DWORD | in | レコード番号を指定します (0 から始まるインデックス)。EIT 内のレコード数を取得するには IDVB_EIT::GetCountOfRecords を呼び出します。 |
| pwVal | WORD* | out | event_id フィールドを受け取る変数へのポインター。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれます。
| リターンコード | 説明 |
|---|---|
| NULL ポインター引数です。 | |
| インデックスが範囲外です。 | |
| メソッドが成功しました。 |
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| dwRecordIndex | DWORD | in | レコード番号を指定します (0 から始まるインデックス)。EIT 内のレコード数を取得するには IDVB_EIT::GetCountOfRecords を呼び出します。 |
| pmdtVal | MPEG_DATE_AND_TIME* | out | 呼び出し側が確保した MPEG_DATE_AND_TIME 構造体へのポインター。このメソッドは、イベントの開始時刻をこの構造体に格納します。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれます。
| リターンコード | 説明 |
|---|---|
| NULL ポインター引数です。 | |
| インデックスが範囲外です。 | |
| メソッドが成功しました。 |
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| dwRecordIndex | DWORD | in | レコード番号を指定します (0 から始まるインデックス)。EIT 内のレコード数を取得するには IDVB_EIT::GetCountOfRecords を呼び出します。 |
| pmdVal | MPEG_TIME* | out | 呼び出し側が確保した MPEG_DURATION 構造体へのポインター。このメソッドは、イベントの継続時間をこの構造体に格納します。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれます。
| リターンコード | 説明 |
|---|---|
| NULL ポインター引数です。 | |
| インデックスが範囲外です。 | |
| メソッドが成功しました。 |
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| dwRecordIndex | DWORD | in | イベントのレコード番号を指定します (0 から始まるインデックス)。EIT 内のレコード数を取得するには IDVB_EIT::GetCountOfRecords を呼び出します。 |
| pbVal | BYTE* | out | running_status フィールドを受け取る変数へのポインター。詳細については、IDVB_RST::GetRecordRunningStatus メソッドの解説セクションを参照してください。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれます。
| リターンコード | 説明 |
|---|---|
| NULL ポインター引数です。 | |
| インデックスが範囲外です。 | |
| メソッドが成功しました。 |
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| dwRecordIndex | DWORD | in | イベントのレコード番号を指定します (0 から始まるインデックス)。EIT 内のレコード数を取得するには IDVB_EIT::GetCountOfRecords を呼び出します。 |
| pfVal | BOOL* | out | Boolean 値を受け取る変数へのポインター。free_CA_mode ビットが設定されている場合、値は TRUE になり、1 つ以上の stream がスクランブルされていることを示します。それ以外の場合、値は FALSE になります。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれます。
| リターンコード | 説明 |
|---|---|
| NULL ポインター引数です。 | |
| インデックスが範囲外です。 | |
| メソッドが成功しました。 |
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| dwRecordIndex | DWORD | in | レコード番号を指定します (0 から始まるインデックス)。EIT 内のレコード数を取得するには IDVB_EIT::GetCountOfRecords を呼び出します。 |
| pdwVal | DWORD* | out | descriptor の数を受け取る変数へのポインター。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれます。
| リターンコード | 説明 |
|---|---|
| NULL ポインター引数です。 | |
| インデックスが範囲外です。 | |
| メソッドが成功しました。 |
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| dwRecordIndex | DWORD | in | レコード番号を指定します (0 から始まるインデックス)。EIT 内のレコード数を取得するには IDVB_EIT::GetCountOfRecords を呼び出します。 |
| dwIndex | DWORD | in | 取得する descriptor を指定します (0 から始まるインデックス)。特定のレコードの descriptor 数を取得するには、IDVB_EIT::GetRecordCountOfDescriptors メソッドを呼び出します。 |
| ppDescriptor | IGenericDescriptor** | out | IGenericDescriptor インターフェイスポインターを受け取る変数のアドレス。このインターフェイスを使用して descriptor 内の情報を取得します。呼び出し側はインターフェイスを解放する必要があります。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれます。
| リターンコード | 説明 |
|---|---|
| NULL ポインター引数です。 | |
| インデックスが範囲外です。 | |
| メソッドが成功しました。 |
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| dwRecordIndex | DWORD | in | レコード番号を指定します (0 から始まるインデックス)。EIT 内のレコード数を取得するには IDVB_EIT::GetCountOfRecords を呼び出します。 |
| bTag | BYTE | in | 検索対象の descriptor タグを指定します。 |
| pdwCookie | DWORD* | inoutoptional | descriptor リスト内の開始位置を指定する変数へのポインター。このパラメーターは省略可能です。pdwCookie の値が NULL の場合、検索はリストの最初の descriptor から開始されます。それ以外の場合、検索は pdwCookie で指定された位置から開始されます。メソッドが返るとき、pdwCookie パラメーターには、次に一致する descriptor の位置が (存在する場合) 格納されます。このパラメーターを使用すると、特定の descriptor タグのすべてのインスタンスを探して descriptor リストを反復処理できます。 |
| ppDescriptor | IGenericDescriptor** | out | IGenericDescriptor インターフェイスポインターを受け取る変数のアドレス。このインターフェイスを使用して descriptor 内の情報を取得します。呼び出し側はインターフェイスを解放する必要があります。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれます。
| リターンコード | 説明 |
|---|---|
| インデックスが範囲外です。 | |
| 指定されたタグが見つかりませんでした。 | |
| このレコードには、このタグを持つ descriptor がさらに 1 つ以上含まれています。 | |
| このレコードには、このタグを持つ descriptor はこれ以上含まれていません。 | |
| メソッドが成功しました。 |
解説(Remarks)
pdwCookie の値が NULL でない場合、このメソッドは MPEG2_S_NO_MORE_DATA_AVAILABLE または MPEG2_S_MORE_DATA_AVAILABLE のいずれかを返し、検索条件に一致するタグがレコードにさらに含まれているかどうかを示します。
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| hNextTableAvailable | HANDLE | in | 呼び出し側が作成したイベントへのハンドル。次の table が到着すると、オブジェクトはこのイベントをシグナル状態にします。イベントがシグナル状態になったら、IDVB_EIT::GetNextTable メソッドを呼び出して table を取得します。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれます。
| リターンコード | 説明 |
|---|---|
| このテーブルはすでに next テーブルです。 | |
| 引数が無効です。hNextTableAvailable を NULL にすることはできません。 | |
| このメソッドはすでに呼び出されています。 | |
| メソッドが成功しました。 |
解説(Remarks)
このメソッドは current テーブルにのみ適用されます。それ以外の場合、このメソッドは E_ACCESSDENIED を返します。
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| ppEIT | IDVB_EIT** | out | IDVB_EIT インターフェイスポインターを受け取る変数のアドレス。呼び出し側はインターフェイスを解放する必要があります。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれます。
| リターンコード | 説明 |
|---|---|
| このテーブルは current ではありません。 | |
| 失敗しました。 | |
| メソッドが成功しました。 |
解説(Remarks)
このメソッドは current テーブルにのみ適用されます。それ以外の場合、このメソッドは E_ACCESSDENIED を返します。
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| hNextTableIsCurrent | HANDLE | in | 呼び出し側が作成したイベントへのハンドル。table が current になると、オブジェクトはこのイベントをシグナル状態にします。 |
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれます。
| リターンコード | 説明 |
|---|---|
| このテーブルはすでに current テーブルです。 | |
| 引数が無効です。hNextTableIsCurrent を NULL にすることはできません。 | |
| このメソッドはすでに呼び出されています。 | |
| メソッドが成功しました。 |
解説(Remarks)
このメソッドは next テーブルにのみ適用されます。それ以外の場合、このメソッドは E_ACCESSDENIED を返します。
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
戻り値
このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれます。
| リターンコード | 説明 |
|---|---|
| このテーブルはすでに current です。 | |
| RegisterForWhenCurrent メソッドが呼び出されていません。 | |
| 新しい current テーブルの形式が正しくありません。 | |
| メソッドが成功しました。 |
解説(Remarks)
このメソッドは、current になった next テーブルにのみ適用されます。このメソッドを呼び出す前に、IDVB_EIT::RegisterForWhenCurrent を呼び出し、イベントがシグナル状態になるのを待ちます。
このトピックは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
| pdwVersionHash | DWORD* | out | ハッシュ値を受け取ります。 |
戻り値
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IDVB_EIT "{442DB029-02CB-4495-8B92-1C13375BCE99}" #usecom global IDVB_EIT IID_IDVB_EIT "{}" #comfunc global IDVB_EIT_Initialize 3 sptr,sptr #comfunc global IDVB_EIT_GetVersionNumber 4 var #comfunc global IDVB_EIT_GetServiceId 5 var #comfunc global IDVB_EIT_GetTransportStreamId 6 var #comfunc global IDVB_EIT_GetOriginalNetworkId 7 var #comfunc global IDVB_EIT_GetSegmentLastSectionNumber 8 var #comfunc global IDVB_EIT_GetLastTableId 9 var #comfunc global IDVB_EIT_GetCountOfRecords 10 var #comfunc global IDVB_EIT_GetRecordEventId 11 int,var #comfunc global IDVB_EIT_GetRecordStartTime 12 int,var #comfunc global IDVB_EIT_GetRecordDuration 13 int,var #comfunc global IDVB_EIT_GetRecordRunningStatus 14 int,var #comfunc global IDVB_EIT_GetRecordFreeCAMode 15 int,var #comfunc global IDVB_EIT_GetRecordCountOfDescriptors 16 int,var #comfunc global IDVB_EIT_GetRecordDescriptorByIndex 17 int,int,sptr #comfunc global IDVB_EIT_GetRecordDescriptorByTag 18 int,int,var,sptr #comfunc global IDVB_EIT_RegisterForNextTable 19 sptr #comfunc global IDVB_EIT_GetNextTable 20 sptr #comfunc global IDVB_EIT_RegisterForWhenCurrent 21 sptr #comfunc global IDVB_EIT_ConvertNextToCurrent 22 #comfunc global IDVB_EIT_GetVersionHash 23 var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IDVB_EIT "{442DB029-02CB-4495-8B92-1C13375BCE99}" #usecom global IDVB_EIT IID_IDVB_EIT "{}" #comfunc global IDVB_EIT_Initialize 3 sptr,sptr #comfunc global IDVB_EIT_GetVersionNumber 4 sptr #comfunc global IDVB_EIT_GetServiceId 5 sptr #comfunc global IDVB_EIT_GetTransportStreamId 6 sptr #comfunc global IDVB_EIT_GetOriginalNetworkId 7 sptr #comfunc global IDVB_EIT_GetSegmentLastSectionNumber 8 sptr #comfunc global IDVB_EIT_GetLastTableId 9 sptr #comfunc global IDVB_EIT_GetCountOfRecords 10 sptr #comfunc global IDVB_EIT_GetRecordEventId 11 int,sptr #comfunc global IDVB_EIT_GetRecordStartTime 12 int,sptr #comfunc global IDVB_EIT_GetRecordDuration 13 int,sptr #comfunc global IDVB_EIT_GetRecordRunningStatus 14 int,sptr #comfunc global IDVB_EIT_GetRecordFreeCAMode 15 int,sptr #comfunc global IDVB_EIT_GetRecordCountOfDescriptors 16 int,sptr #comfunc global IDVB_EIT_GetRecordDescriptorByIndex 17 int,int,sptr #comfunc global IDVB_EIT_GetRecordDescriptorByTag 18 int,int,sptr,sptr #comfunc global IDVB_EIT_RegisterForNextTable 19 sptr #comfunc global IDVB_EIT_GetNextTable 20 sptr #comfunc global IDVB_EIT_RegisterForWhenCurrent 21 sptr #comfunc global IDVB_EIT_ConvertNextToCurrent 22 #comfunc global IDVB_EIT_GetVersionHash 23 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。