IISDB_BIT

COM

IID537cd71e-0e46-4173-9001-ba043f3e49e2継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

Integrated Services Digital Broadcasting (ISDB) の broadcaster information table (BIT) から情報を取得するメソッドを実装します。BIT には、ブロードキャスター単位と、各ブロードキャスター単位のサービス情報伝送パラメーターが含まれます。

メソッド 13

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

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

Integrated Services Digital Broadcasting (ISDB) の broadcaster information table (BIT) についてキャプチャしたテーブルセクションデータを使用して、オブジェクトを初期化します。

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

戻り値

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

vtbl 4 HRESULT GetVersionNumber(BYTE* pbVal)

Integrated Services Digital Broadcasting (ISDB) の broadcaster information table (BIT) のバージョン番号を取得します。

pbVal

BYTE*

out

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

戻り値

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

vtbl 5 HRESULT GetOriginalNetworkId(WORD* pwVal)

Integrated Services Digital Broadcasting (ISDB) の broadcaster information table (BIT) から、MPEG-2 transport stream を発信したブロードキャスターを識別する識別子を取得します。

pwVal

WORD*

out

original network ID を受け取ります。

戻り値

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

vtbl 6 HRESULT GetBroadcastViewPropriety(BYTE* pbVal)

Integrated Services Digital Broadcasting (ISDB) の broadcaster information table (BIT) 内のレコードから broadcast_view_propriety フラグを返します。

pbVal

BYTE*

out

broadcast_view_propriety フラグを受け取ります。

戻り値

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

vtbl 7 HRESULT GetCountOfTableDescriptors(DWORD* pdwVal)

Integrated Services Digital Broadcasting (ISDB) の broadcaster information table (BIT) から broadcaster_descriptors_length フィールドの値を取得します。

pdwVal

DWORD*

out

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

戻り値

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

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

Integrated Services Digital Broadcasting (ISDB) の broadcaster information table (BIT) 内の指定したテーブルの記述子を返します。

dwIndex	DWORD	in	レコード番号を 0 から始まるインデックスで指定します。 BIT 内のレコード数を取得するには IISDB_BIT::GetCountOfRecords メソッドを呼び出します。
ppDescriptor	IGenericDescriptor**	out	取得する記述子を 0 から始まるインデックスで指定します。特定のレコードの記述子数を取得するには IISDB_BIT::GetRecordCountOfDescriptors メソッドを呼び出します。

戻り値

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

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

Integrated Services Digital Broadcasting (ISDB) の broadcaster information table (BIT) 内のサブテーブルを検索します。

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

戻り値

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

vtbl 10 HRESULT GetCountOfRecords(DWORD* pdwVal)

Integrated Services Digital Broadcasting (ISDB) の broadcaster information table (BIT) 内のレコード数を取得します。

pdwVal

DWORD*

out

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

戻り値

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

vtbl 11 HRESULT GetRecordBroadcasterId(DWORD dwRecordIndex, BYTE* pbVal)

Integrated Services Digital Broadcasting (ISDB) の broadcaster information table (BIT) 内のレコードから broadcaster_id フィールドを取得します。

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

戻り値

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

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

Integrated Services Digital Broadcasting (ISDB) の broadcaster information table (BIT) 内のサブテーブルの記述子数を返します。

dwRecordIndex

DWORD

レコード番号を 0 から始まるインデックスで指定します。BIT 内のレコード数を取得するには IISDB_BIT::GetCountOfRecords

メソッドを呼び出します。

pdwVal

DWORD*

out

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

戻り値

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

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

Integrated Services Digital Broadcasting (ISDB) の broadcaster information table (BIT) 内の指定したレコードの記述子を返します。

dwRecordIndex	DWORD	in	レコード番号を 0 から始まるインデックスで指定します。 BIT 内のレコード数を取得するには IISDB_BIT::GetCountOfRecords メソッドを呼び出します。
dwIndex	DWORD	in	取得する記述子を 0 から始まるインデックスで指定します。特定のレコードの記述子数を取得するには IISDB_BIT::GetRecordCountOfDescriptors メソッドを呼び出します。
ppDescriptor	IGenericDescriptor**	out	記述子が実装する IGenericDescriptor インターフェイスへのポインター。

戻り値

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

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

Integrated Services Digital Broadcasting (ISDB) の broadcaster information table (BIT) 内のレコードを検索します。

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

戻り値

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

vtbl 15 HRESULT GetVersionHash(DWORD* pdwVersionHash)

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

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_BIT "{537CD71E-0E46-4173-9001-BA043F3E49E2}"
#usecom global IISDB_BIT IID_IISDB_BIT "{}"
#comfunc global IISDB_BIT_Initialize                   3 sptr,sptr
#comfunc global IISDB_BIT_GetVersionNumber             4 var
#comfunc global IISDB_BIT_GetOriginalNetworkId         5 var
#comfunc global IISDB_BIT_GetBroadcastViewPropriety    6 var
#comfunc global IISDB_BIT_GetCountOfTableDescriptors   7 var
#comfunc global IISDB_BIT_GetTableDescriptorByIndex    8 int,sptr
#comfunc global IISDB_BIT_GetTableDescriptorByTag      9 int,var,sptr
#comfunc global IISDB_BIT_GetCountOfRecords            10 var
#comfunc global IISDB_BIT_GetRecordBroadcasterId       11 int,var
#comfunc global IISDB_BIT_GetRecordCountOfDescriptors  12 int,var
#comfunc global IISDB_BIT_GetRecordDescriptorByIndex   13 int,int,sptr
#comfunc global IISDB_BIT_GetRecordDescriptorByTag     14 int,int,var,sptr
#comfunc global IISDB_BIT_GetVersionHash               15 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IISDB_BIT "{537CD71E-0E46-4173-9001-BA043F3E49E2}"
#usecom global IISDB_BIT IID_IISDB_BIT "{}"
#comfunc global IISDB_BIT_Initialize                   3 sptr,sptr
#comfunc global IISDB_BIT_GetVersionNumber             4 sptr
#comfunc global IISDB_BIT_GetOriginalNetworkId         5 sptr
#comfunc global IISDB_BIT_GetBroadcastViewPropriety    6 sptr
#comfunc global IISDB_BIT_GetCountOfTableDescriptors   7 sptr
#comfunc global IISDB_BIT_GetTableDescriptorByIndex    8 int,sptr
#comfunc global IISDB_BIT_GetTableDescriptorByTag      9 int,sptr,sptr
#comfunc global IISDB_BIT_GetCountOfRecords            10 sptr
#comfunc global IISDB_BIT_GetRecordBroadcasterId       11 int,sptr
#comfunc global IISDB_BIT_GetRecordCountOfDescriptors  12 int,sptr
#comfunc global IISDB_BIT_GetRecordDescriptorByIndex   13 int,int,sptr
#comfunc global IISDB_BIT_GetRecordDescriptorByTag     14 int,int,sptr,sptr
#comfunc global IISDB_BIT_GetVersionHash               15 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。