IISDB_CDT

COM

IID25fa92c2-8b80-4787-a841-3a0e8f17984b継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

Integrated Services Digital Broadcasting (ISDB) の common data table (CDT) から情報を取得するメソッドを実装します。CDT には、受信機で必要とされ不揮発性メモリに保存される、企業ロゴなどのデータが含まれます。

メソッド 12

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

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

Integrated Services Digital Broadcasting System (ISDB) の common data table (CDT) から取得したテーブルセクションデータを使用して、オブジェクトを初期化します。

pSectionList	ISectionList*	in	セクションデータを保持するオブジェクトの ISectionList インターフェイスへのポインター。
pMPEGData	IMpeg2Data*	in	MPEG-2 Sections and Tables フィルターの IMpeg2Data インターフェイスへのポインター。
bSectionNumber	BYTE	in	section_number フィールドの値を指定します。

戻り値

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 4 HRESULT GetVersionNumber(BYTE* pbVal)

Integrated Services Digital Broadcasting (ISDB) の common data table (CDT) のバージョン番号を取得します。

pbVal

BYTE*

out

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

戻り値

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 5 HRESULT GetDownloadDataId(WORD* pwVal)

Integrated Services Digital Broadcasting (ISDB) の common data table (CDT) 内のロゴ伝送記述子から download_data_id フィールドの値を受け取ります。download_data_id フィールドは、ダウンロード対象のデータを識別します。

pwVal

WORD*

out

download_data_id フィールドの値を受け取ります。この値は、ロゴデータを含む CDT の table_id_extension フィールドの値と同じです。

戻り値

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 6 HRESULT GetSectionNumber(BYTE* pbVal)

Integrated Services Digital Broadcasting (ISDB) の common data table (CDT) から section_number フィールドの値を取得します。

pbVal

BYTE*

out

section_number フィールドの値を受け取ります。

戻り値

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 7 HRESULT GetOriginalNetworkId(WORD* pwVal)

Integrated Services Digital Broadcasting (ISDB) の common data table (CDT) から、MPEG-2 トランスポートストリームを送出した放送事業者を識別する識別子を取得します。

pwVal

WORD*

out

original network ID を受け取ります。

戻り値

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 8 HRESULT GetDataType(BYTE* pbVal)

Integrated Services Digital Broadcasting (ISDB) の common data table (CDT) からデータ型の値を受け取ります。

pbVal

BYTE*

out

データ型の値を受け取ります。

戻り値

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 9 HRESULT GetCountOfTableDescriptors(DWORD* pdwVal)

Integrated Services Digital Broadcasting (ISDB) の common data table (CDT) 内のロゴ用記述子の数を返します。

pdwVal

DWORD*

out

ロゴ記述子の数を受け取ります。

戻り値

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 10 HRESULT GetTableDescriptorByIndex(DWORD dwIndex, IGenericDescriptor** ppDescriptor)

Integrated Services Digital Broadcasting (ISDB) の common data table (CDT) から、指定したロゴ伝送記述子を返します。

dwIndex	DWORD	in	取得する記述子を、ゼロから始まるインデックスで指定します。テーブル記述子の数を取得するには、IISDB_CDT::GetCountOfTableDescriptors メソッドを呼び出します。
ppDescriptor	IGenericDescriptor**	out	記述子によって実装された IGenericDescriptor インターフェイスへのポインターを受け取ります。呼び出し元はこのインターフェイスを解放する必要があります。

戻り値

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 11 HRESULT GetTableDescriptorByTag(BYTE bTag, DWORD* pdwCookie, IGenericDescriptor** ppDescriptor)

Integrated Services Digital Broadcasting (ISDB) の common data table (CDT) 内のサブテーブルを検索します。

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

戻り値

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 12 HRESULT GetSizeOfDataModule(DWORD* pdwVal)

Integrated Services Digital Broadcasting (ISDB) の common data table (CDT) からデータモジュールのサイズを取得します。

pdwVal

DWORD*

out

データモジュールのサイズを受け取ります。

戻り値

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 13 HRESULT GetDataModule(BYTE** pbData)

Integrated Services Digital Broadcasting (ISDB) の common data table (CDT) からデータモジュールを受け取ります。

pbData

BYTE**

out

データモジュールを受け取るために割り当てられたメモリブロックへのポインター。このメモリの解放は呼び出し元の責任です。

戻り値

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 14 HRESULT GetVersionHash(DWORD* pdwVersionHash)

この Integrated Services Digital Broadcasting (ISDB) の common data table (CDT) インスタンスのハッシュ値を返します。

pdwVersionHash

DWORD*

out

ハッシュ値を受け取ります。

戻り値

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IISDB_CDT "{25FA92C2-8B80-4787-A841-3A0E8F17984B}"
#usecom global IISDB_CDT IID_IISDB_CDT "{}"
#comfunc global IISDB_CDT_Initialize                  3 sptr,sptr,int
#comfunc global IISDB_CDT_GetVersionNumber            4 var
#comfunc global IISDB_CDT_GetDownloadDataId           5 var
#comfunc global IISDB_CDT_GetSectionNumber            6 var
#comfunc global IISDB_CDT_GetOriginalNetworkId        7 var
#comfunc global IISDB_CDT_GetDataType                 8 var
#comfunc global IISDB_CDT_GetCountOfTableDescriptors  9 var
#comfunc global IISDB_CDT_GetTableDescriptorByIndex   10 int,sptr
#comfunc global IISDB_CDT_GetTableDescriptorByTag     11 int,var,sptr
#comfunc global IISDB_CDT_GetSizeOfDataModule         12 var
#comfunc global IISDB_CDT_GetDataModule               13 var
#comfunc global IISDB_CDT_GetVersionHash              14 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IISDB_CDT "{25FA92C2-8B80-4787-A841-3A0E8F17984B}"
#usecom global IISDB_CDT IID_IISDB_CDT "{}"
#comfunc global IISDB_CDT_Initialize                  3 sptr,sptr,int
#comfunc global IISDB_CDT_GetVersionNumber            4 sptr
#comfunc global IISDB_CDT_GetDownloadDataId           5 sptr
#comfunc global IISDB_CDT_GetSectionNumber            6 sptr
#comfunc global IISDB_CDT_GetOriginalNetworkId        7 sptr
#comfunc global IISDB_CDT_GetDataType                 8 sptr
#comfunc global IISDB_CDT_GetCountOfTableDescriptors  9 sptr
#comfunc global IISDB_CDT_GetTableDescriptorByIndex   10 int,sptr
#comfunc global IISDB_CDT_GetTableDescriptorByTag     11 int,sptr,sptr
#comfunc global IISDB_CDT_GetSizeOfDataModule         12 sptr
#comfunc global IISDB_CDT_GetDataModule               13 sptr
#comfunc global IISDB_CDT_GetVersionHash              14 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。