ICAT

COM

IID7c6995fb-2a31-4bd7-953e-b1ad7fb7d31c継承元IUnknown自前メソッド開始 vtbl3

メソッド 9

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

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

pSectionList	ISectionList*	in	CATを構成するセクション一覧ISectionListへのポインタ。
pMPEGData	IMpeg2Data*	in	データ取得元のIMpeg2Dataインターフェイスへのポインタ。

vtbl 4 HRESULT GetVersionNumber(BYTE* pbVal)

pbVal

BYTE*

out

CATのバージョン番号を受け取るBYTEポインタ。

vtbl 5 HRESULT GetCountOfTableDescriptors(DWORD* pdwVal)

pdwVal

DWORD*

out

テーブルレベルのディスクリプタ数を受け取るDWORDポインタ。

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

dwIndex	DWORD	in	対象ディスクリプタの0起点インデックスを指定する。
ppDescriptor	IGenericDescriptor**	out	指定ディスクリプタIGenericDescriptorを受け取るポインタ。

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

bTag	BYTE	in	検索対象のディスクリプタタグを指定する。
pdwCookie	DWORD*	inout	同一タグの反復検索に用いる位置クッキーを受け渡すDWORDポインタ。
ppDescriptor	IGenericDescriptor**	out	該当ディスクリプタIGenericDescriptorを受け取るポインタ。

vtbl 8 HRESULT RegisterForNextTable(HANDLE hNextTableAvailable)

hNextTableAvailable

HANDLE

次バージョンのテーブル到着を通知するイベントのハンドル。

vtbl 9 HRESULT GetNextTable(DWORD dwTimeout, ICAT** ppCAT)

dwTimeout	DWORD	in	次テーブル取得待機のタイムアウトをミリ秒単位で指定する。
ppCAT	ICAT**	out	次バージョンのCATインターフェイスを受け取るポインタ。

vtbl 10 HRESULT RegisterForWhenCurrent(HANDLE hNextTableIsCurrent)

hNextTableIsCurrent

HANDLE

次テーブルが現行になった際に通知するイベントのハンドル。

vtbl 11 HRESULT ConvertNextToCurrent()

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_ICAT "{7C6995FB-2A31-4BD7-953E-B1AD7FB7D31C}"
#usecom global ICAT IID_ICAT "{}"
#comfunc global ICAT_Initialize                  3 sptr,sptr
#comfunc global ICAT_GetVersionNumber            4 var
#comfunc global ICAT_GetCountOfTableDescriptors  5 var
#comfunc global ICAT_GetTableDescriptorByIndex   6 int,sptr
#comfunc global ICAT_GetTableDescriptorByTag     7 int,var,sptr
#comfunc global ICAT_RegisterForNextTable        8 sptr
#comfunc global ICAT_GetNextTable                9 int,sptr
#comfunc global ICAT_RegisterForWhenCurrent      10 sptr
#comfunc global ICAT_ConvertNextToCurrent        11
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ICAT "{7C6995FB-2A31-4BD7-953E-B1AD7FB7D31C}"
#usecom global ICAT IID_ICAT "{}"
#comfunc global ICAT_Initialize                  3 sptr,sptr
#comfunc global ICAT_GetVersionNumber            4 sptr
#comfunc global ICAT_GetCountOfTableDescriptors  5 sptr
#comfunc global ICAT_GetTableDescriptorByIndex   6 int,sptr
#comfunc global ICAT_GetTableDescriptorByTag     7 int,sptr,sptr
#comfunc global ICAT_RegisterForNextTable        8 sptr
#comfunc global ICAT_GetNextTable                9 int,sptr
#comfunc global ICAT_RegisterForWhenCurrent      10 sptr
#comfunc global ICAT_ConvertNextToCurrent        11
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。