IIsdbSIParameterDescriptor
COM公式ドキュメント
Integrated Services Digital Broadcasting (ISDB) の service information (SI) パラメーター記述子からデータを取得するメソッドを実装します。SI パラメーター記述子は program map table (PMT) または network information table (NIT) に現れます。
メソッド 8
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
service information (SI) パラメーター記述子を識別するタグを取得します。
| pbVal | BYTE* | out | タグ値を受け取ります。SI パラメーター記述子の場合、この値は 0xD7 です。 |
戻り値
このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
service information (SI) パラメーター記述子の本体長をバイト単位で取得します。
| pbVal | BYTE* | out | 記述子の長さを受け取ります。 |
戻り値
このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
service information (SI) パラメーター記述子からパラメーターのバージョン番号を取得します。このバージョン番号は、パラメーターが更新されるたびに 1 ずつ増加します。
| pbVal | BYTE* | out | バージョン番号を受け取ります。 |
戻り値
このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
service information (SI) パラメーター記述子から、パラメーターが有効になる時刻を取得します。
| pVal | MPEG_DATE* | out | パラメーターが有効になる日時値を受け取ります。 |
戻り値
このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
service information (SI) パラメーター記述子内のテーブル記述子の数を取得します。
| pbVal | BYTE* | out | テーブル記述子の数を受け取ります。 |
戻り値
このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
service information (SI) パラメーター記述子内のテーブル記述子の識別子を取得します。
| bRecordIndex | BYTE | in | SI テーブル記述子の 0 から始まるインデックス。テーブル記述子の数を取得するには、IIsdbSIParameterDescriptor::GetRecordNumberOfTable メソッドを呼び出します。 |
| pbVal | BYTE* | out | テーブル記述子の識別子を受け取ります。 |
戻り値
このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
service information (SI) パラメーター記述子内のテーブル記述子の本体長を取得します。
| bRecordIndex | BYTE | in | SI テーブル記述子の 0 から始まるインデックス。テーブル記述子の数を取得するには、IIsdbSIParameterDescriptor::GetRecordNumberOfTable メソッドを呼び出します。 |
| pbVal | BYTE* | out | テーブル記述子の長さをバイト単位で受け取ります。 |
戻り値
このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
service information (SI) パラメーター記述子内のテーブル記述子から記述データを取得します。
| bRecordIndex | BYTE | in | SI テーブル記述子の 0 から始まるインデックス。テーブル記述子の数を取得するには、IIsdbSIParameterDescriptor::GetRecordNumberOfTable メソッドを呼び出します。 |
| pbBufferLength | BYTE* | inout | 入力時には、取得するテーブル記述子データの長さをバイト単位で指定します。出力時には、実際のデータ長を返します。 |
| pbBuffer | BYTE* | out | テーブル記述子データを受け取ります。 |
戻り値
このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IIsdbSIParameterDescriptor "{F837DC36-867C-426A-9111-F62093951A45}" #usecom global IIsdbSIParameterDescriptor IID_IIsdbSIParameterDescriptor "{}" #comfunc global IIsdbSIParameterDescriptor_GetTag 3 var #comfunc global IIsdbSIParameterDescriptor_GetLength 4 var #comfunc global IIsdbSIParameterDescriptor_GetParameterVersion 5 var #comfunc global IIsdbSIParameterDescriptor_GetUpdateTime 6 var #comfunc global IIsdbSIParameterDescriptor_GetRecordNumberOfTable 7 var #comfunc global IIsdbSIParameterDescriptor_GetTableId 8 int,var #comfunc global IIsdbSIParameterDescriptor_GetTableDescriptionLength 9 int,var #comfunc global IIsdbSIParameterDescriptor_GetTableDescriptionBytes 10 int,var,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IIsdbSIParameterDescriptor "{F837DC36-867C-426A-9111-F62093951A45}" #usecom global IIsdbSIParameterDescriptor IID_IIsdbSIParameterDescriptor "{}" #comfunc global IIsdbSIParameterDescriptor_GetTag 3 sptr #comfunc global IIsdbSIParameterDescriptor_GetLength 4 sptr #comfunc global IIsdbSIParameterDescriptor_GetParameterVersion 5 sptr #comfunc global IIsdbSIParameterDescriptor_GetUpdateTime 6 sptr #comfunc global IIsdbSIParameterDescriptor_GetRecordNumberOfTable 7 sptr #comfunc global IIsdbSIParameterDescriptor_GetTableId 8 int,sptr #comfunc global IIsdbSIParameterDescriptor_GetTableDescriptionLength 9 int,sptr #comfunc global IIsdbSIParameterDescriptor_GetTableDescriptionBytes 10 int,sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。