ホーム › Media.DirectShow.Tv › IATSC_EIT

IATSC_EIT

COM

📘 Microsoft Learn (日本語) · English

IIDd7c212d7-76a2-4b4b-aa56-846879a80096継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

このトピックは、Microsoft Windows XP Media Center Edition 2005 用 Update Rollup 2 以降に適用されます。

メソッド 13

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

vtbl 3 HRESULT Initialize(ISectionList* pSectionList, IMpeg2Data* pMPEGData)

このトピックは、Microsoft Windows XP Media Center Edition 2005 用 Update Rollup 2 以降に適用されます。

pSectionList	ISectionList*	inoptional	セクションデータを含む SectionList オブジェクトの ISectionList インターフェイスへのポインター。
pMPEGData	IMpeg2Data*	inoptional	MPEG-2 Sections and Tables フィルターの IMpeg2Data インターフェイスへのポインター。

戻り値

このメソッドは HRESULT を返します。指定できる値には次の表のものが含まれます。

リターンコード	説明
E_INVALIDARG	引数が無効です。
MPEG2_E_ALREADY_INITIALIZED	オブジェクトは既に初期化されています。
S_OK	メソッドは成功しました。

vtbl 4 HRESULT GetVersionNumber(BYTE* pbVal)

このトピックは、Microsoft Windows XP Media Center Edition 2005 用 Update Rollup 2 以降に適用されます。

pbVal

BYTE*

out

version_number フィールドを受け取ります。

戻り値

このメソッドは HRESULT を返します。指定できる値には次の表のものが含まれます。

リターンコード	説明
E_POINTER	NULL ポインター引数です。
S_OK	メソッドは成功しました。

vtbl 5 HRESULT GetSourceId(WORD* pwVal)

このトピックは、Microsoft Windows XP Media Center Edition 2005 用 Update Rollup 2 以降に適用されます。

pwVal

WORD*

out

source_id フィールドを受け取ります。

戻り値

このメソッドは HRESULT を返します。指定できる値には次の表のものが含まれます。

リターンコード	説明
E_POINTER	NULL ポインター引数です。
S_OK	メソッドは成功しました。

vtbl 6 HRESULT GetProtocolVersion(BYTE* pbVal)

このトピックは、Microsoft Windows XP Media Center Edition 2005 用 Update Rollup 2 以降に適用されます。

pbVal

BYTE*

out

protocol_version フィールドを受け取ります。

戻り値

このメソッドは HRESULT を返します。指定できる値には次の表のものが含まれます。

リターンコード	説明
E_POINTER	NULL ポインター引数です。
S_OK	メソッドは成功しました。

vtbl 7 HRESULT GetCountOfRecords(DWORD* pdwVal)

このトピックは、Microsoft Windows XP Media Center Edition 2005 用 Update Rollup 2 以降に適用されます。

pdwVal

DWORD*

out

レコード数を受け取ります。

戻り値

このメソッドは HRESULT を返します。指定できる値には次の表のものが含まれます。

リターンコード	説明
E_POINTER	NULL ポインター引数です。
S_OK	メソッドは成功しました。

vtbl 8 HRESULT GetRecordEventId(DWORD dwRecordIndex, WORD* pwVal)

このトピックは、Microsoft Windows XP Media Center Edition 2005 用 Update Rollup 2 以降に適用されます。

dwRecordIndex	DWORD	in	レコード番号を 0 から始まるインデックスで指定します。EIT 内のレコード数を取得するには、IATSC_EIT::GetCountOfRecords メソッドを呼び出します。
pwVal	WORD*	out	event_id フィールドを受け取ります。

戻り値

このメソッドは HRESULT を返します。指定できる値には次の表のものが含まれます。

リターンコード	説明
E_POINTER	NULL ポインター引数です。
MPEG2_E_OUT_OF_BOUNDS	インデックスが範囲外です。
S_OK	メソッドは成功しました。

vtbl 9 HRESULT GetRecordStartTime(DWORD dwRecordIndex, MPEG_DATE_AND_TIME* pmdtVal)

このトピックは、Microsoft Windows XP Media Center Edition 2005 用 Update Rollup 2 以降に適用されます。

dwRecordIndex	DWORD	in	レコード番号を 0 から始まるインデックスで指定します。EIT 内のレコード数を取得するには、IATSC_EIT::GetCountOfRecords メソッドを呼び出します。
pmdtVal	MPEG_DATE_AND_TIME*	out	呼び出し元が確保した MPEG_DATE_AND_TIME 構造体へのポインター。このメソッドは、この構造体にイベントの開始時刻を格納します。

戻り値

このメソッドは HRESULT を返します。指定できる値には次の表のものが含まれます。

リターンコード	説明
E_POINTER	NULL ポインター引数です。
MPEG2_E_OUT_OF_BOUNDS	インデックスが範囲外です。
S_OK	メソッドは成功しました。

vtbl 10 HRESULT GetRecordEtmLocation(DWORD dwRecordIndex, BYTE* pbVal)

このトピックは、Microsoft Windows XP Media Center Edition 2005 用 Update Rollup 2 以降に適用されます。

dwRecordIndex	DWORD	in	レコード番号を 0 から始まるインデックスで指定します。EIT 内のレコード数を取得するには、IATSC_EIT::GetCountOfRecords メソッドを呼び出します。
pbVal	BYTE*	out	ETM_location フィールドを受け取ります。

戻り値

このメソッドは HRESULT を返します。指定できる値には次の表のものが含まれます。

リターンコード	説明
E_POINTER	NULL ポインター引数です。
MPEG2_E_OUT_OF_BOUNDS	インデックスが範囲外です。
S_OK	メソッドは成功しました。

vtbl 11 HRESULT GetRecordDuration(DWORD dwRecordIndex, MPEG_TIME* pmdVal)

このトピックは、Microsoft Windows XP Media Center Edition 2005 用 Update Rollup 2 以降に適用されます。

dwRecordIndex	DWORD	in	レコード番号を 0 から始まるインデックスで指定します。EIT 内のレコード数を取得するには、IATSC_EIT::GetCountOfRecords メソッドを呼び出します。
pmdVal	MPEG_TIME*	out	呼び出し元が確保した MPEG_DURATION 構造体へのポインター。このメソッドは、この構造体にイベントの継続時間を格納します。

戻り値

このメソッドは HRESULT を返します。指定できる値には次の表のものが含まれます。

リターンコード	説明
E_POINTER	NULL ポインター引数です。
MPEG2_E_OUT_OF_BOUNDS	インデックスが範囲外です。
S_OK	メソッドは成功しました。

vtbl 12 HRESULT GetRecordTitleText(DWORD dwRecordIndex, DWORD* pdwLength, BYTE** ppText)

このトピックは、Microsoft Windows XP Media Center Edition 2005 用 Update Rollup 2 以降に適用されます。

dwRecordIndex	DWORD	in	レコード番号を 0 から始まるインデックスで指定します。EIT 内のレコード数を取得するには、IATSC_EIT::GetCountOfRecords メソッドを呼び出します。
pdwLength	DWORD*	out	タイトルテキストの長さをバイト単位で受け取ります。
ppText	BYTE**	out	テキストバッファーへのポインターを受け取ります。このメソッドがバッファーを確保し、ATSC PSIP Standard A/65 で定義された Multiple String Structure 形式のタイトルテキストを格納します。呼び出し元は CoTaskMemFree を呼び出してバッファーを解放する必要があります。

戻り値

このメソッドは HRESULT を返します。指定できる値には次の表のものが含まれます。

リターンコード	説明
E_OUTOFMEMORY	メモリが不足しています。
E_POINTER	NULL ポインター引数です。
MPEG2_E_OUT_OF_BOUNDS	インデックスが範囲外です。
S_FALSE	このレコードにはタイトルが含まれていません。
S_OK	メソッドは成功しました。

vtbl 13 HRESULT GetRecordCountOfDescriptors(DWORD dwRecordIndex, DWORD* pdwVal)

このトピックは、Microsoft Windows XP Media Center Edition 2005 用 Update Rollup 2 以降に適用されます。

dwRecordIndex	DWORD	in	レコード番号を 0 から始まるインデックスで指定します。EIT 内のレコード数を取得するには、IATSC_EIT::GetCountOfRecords メソッドを呼び出します。
pdwVal	DWORD*	out	記述子の数を受け取ります。

戻り値

このメソッドは HRESULT を返します。指定できる値には次の表のものが含まれます。

リターンコード	説明
MPEG2_E_OUT_OF_BOUNDS	インデックスが範囲外です。
S_OK	メソッドは成功しました。

vtbl 14 HRESULT GetRecordDescriptorByIndex(DWORD dwRecordIndex, DWORD dwIndex, IGenericDescriptor** ppDescriptor)

このトピックは、Microsoft Windows XP Media Center Edition 2005 用 Update Rollup 2 以降に適用されます。

dwRecordIndex	DWORD	in	レコード番号を 0 から始まるインデックスで指定します。EIT 内のレコード数を取得するには、IATSC_EIT::GetCountOfRecords メソッドを呼び出します。
dwIndex	DWORD	in	取得する記述子を 0 から始まるインデックスで指定します。特定のレコードの記述子の数を取得するには、IATSC_EIT::GetRecordCountOfDescriptors メソッドを呼び出します。
ppDescriptor	IGenericDescriptor**	out	IGenericDescriptor インターフェイスへのポインターを受け取ります。このインターフェイスを使用して記述子内の情報を取得します。呼び出し元はこのインターフェイスを解放する必要があります。

戻り値

このメソッドは HRESULT を返します。指定できる値には次の表のものが含まれます。

リターンコード	説明
MPEG2_E_OUT_OF_BOUNDS	インデックスが範囲外です。
S_OK	メソッドは成功しました。

vtbl 15 HRESULT GetRecordDescriptorByTag(DWORD dwRecordIndex, BYTE bTag, DWORD* pdwCookie, IGenericDescriptor** ppDescriptor)

このトピックは、Microsoft Windows XP Media Center Edition 2005 用 Update Rollup 2 以降に適用されます。

dwRecordIndex	DWORD	in	レコード番号を 0 から始まるインデックスで指定します。EIT 内のレコード数を取得するには、IATSC_EIT::GetCountOfRecords メソッドを呼び出します。
bTag	BYTE	in	検索する記述子のタグを指定します。
pdwCookie	DWORD*	inout	記述子リスト内の検索開始位置を指定する変数へのポインター。このパラメーターは省略可能です。pdwCookie の値が NULL の場合、検索はリストの最初の記述子から始まります。それ以外の場合、検索は *pdwCookie で指定された位置から始まります。メソッドが戻るとき、pdwCookie パラメーターには、次に一致する記述子があればその位置が格納されます。このパラメーターを使用すると、記述子リストを反復処理して、特定の記述子タグのすべての出現箇所を検索できます。
ppDescriptor	IGenericDescriptor**	out	IGenericDescriptor インターフェイスへのポインターを受け取ります。このインターフェイスを使用して記述子内の情報を取得します。呼び出し元はこのインターフェイスを解放する必要があります。

戻り値

このメソッドは HRESULT を返します。指定できる値には次の表のものが含まれます。

リターンコード	説明
MPEG2_E_OUT_OF_BOUNDS	インデックスが範囲外です。
MPEG2_E_NOT_PRESENT	指定されたタグが見つかりませんでした。
MPEG2_S_MORE_DATA_AVAILABLE	レコードには、このタグを持つ記述子がさらに 1 つ以上含まれています。
MPEG2_S_NO_MORE_DATA_AVAILABLE	レコードには、このタグを持つ記述子はこれ以上含まれていません。
S_OK	メソッドは成功しました。

解説(Remarks)

pdwCookie の値が NULL でない場合、このメソッドは MPEG2_S_NO_MORE_DATA_AVAILABLE または MPEG2_S_MORE_DATA_AVAILABLE のいずれかを返し、検索条件に一致するタグがレコードにさらに含まれているかどうかを示します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IATSC_EIT "{D7C212D7-76A2-4B4B-AA56-846879A80096}"
#usecom global IATSC_EIT IID_IATSC_EIT "{}"
#comfunc global IATSC_EIT_Initialize                   3 sptr,sptr
#comfunc global IATSC_EIT_GetVersionNumber             4 var
#comfunc global IATSC_EIT_GetSourceId                  5 var
#comfunc global IATSC_EIT_GetProtocolVersion           6 var
#comfunc global IATSC_EIT_GetCountOfRecords            7 var
#comfunc global IATSC_EIT_GetRecordEventId             8 int,var
#comfunc global IATSC_EIT_GetRecordStartTime           9 int,var
#comfunc global IATSC_EIT_GetRecordEtmLocation         10 int,var
#comfunc global IATSC_EIT_GetRecordDuration            11 int,var
#comfunc global IATSC_EIT_GetRecordTitleText           12 int,var,var
#comfunc global IATSC_EIT_GetRecordCountOfDescriptors  13 int,var
#comfunc global IATSC_EIT_GetRecordDescriptorByIndex   14 int,int,sptr
#comfunc global IATSC_EIT_GetRecordDescriptorByTag     15 int,int,var,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IATSC_EIT "{D7C212D7-76A2-4B4B-AA56-846879A80096}"
#usecom global IATSC_EIT IID_IATSC_EIT "{}"
#comfunc global IATSC_EIT_Initialize                   3 sptr,sptr
#comfunc global IATSC_EIT_GetVersionNumber             4 sptr
#comfunc global IATSC_EIT_GetSourceId                  5 sptr
#comfunc global IATSC_EIT_GetProtocolVersion           6 sptr
#comfunc global IATSC_EIT_GetCountOfRecords            7 sptr
#comfunc global IATSC_EIT_GetRecordEventId             8 int,sptr
#comfunc global IATSC_EIT_GetRecordStartTime           9 int,sptr
#comfunc global IATSC_EIT_GetRecordEtmLocation         10 int,sptr
#comfunc global IATSC_EIT_GetRecordDuration            11 int,sptr
#comfunc global IATSC_EIT_GetRecordTitleText           12 int,sptr,sptr
#comfunc global IATSC_EIT_GetRecordCountOfDescriptors  13 int,sptr
#comfunc global IATSC_EIT_GetRecordDescriptorByIndex   14 int,int,sptr
#comfunc global IATSC_EIT_GetRecordDescriptorByTag     15 int,int,sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。