Win32 API 日本語リファレンス
ホーム › Media.DirectShow › IBDA_GuideDataDeliveryService

IBDA_GuideDataDeliveryService

COM
📘 Microsoft Learn (日本語) · English
IIDc0afcb73-23e7-4bc6-bafa-fdc167b4719f継承元IUnknown自前メソッド開始 vtbl3

メソッド 6

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

vtbl 3 HRESULT GetGuideDataType(GUID* pguidDataType)
pguidDataTypeGUID*outガイドデータの形式を識別するGUIDを受け取る出力ポインタ。データの種別を表す。
vtbl 4 HRESULT GetGuideData(DWORD* pulcbBufferLen, BYTE* pbBuffer, DWORD* pulGuideDataPercentageProgress)
pulcbBufferLenDWORD*inout入出力でバッファのバイト長を指定/受け取るポインタ。NULL指定で必要サイズを問い合わせる。
pbBufferBYTE*outガイドデータを書き込む出力バッファへのポインタ。NULLでサイズ取得のみ行う。
pulGuideDataPercentageProgressDWORD*outガイドデータ取得の進捗率(0〜100)を受け取る出力ポインタ。
vtbl 5 HRESULT RequestGuideDataUpdate()
vtbl 6 HRESULT GetTuneXmlFromServiceIdx(ULONGLONG ul64ServiceIdx, LPWSTR* pbstrTuneXml)
ul64ServiceIdxULONGLONGinサービス一覧内の対象サービスを示す0始まりのインデックス値。
pbstrTuneXmlLPWSTR*out選局情報を記述したXML文字列を受け取る出力ポインタ。呼出側が解放する。
vtbl 7 HRESULT GetServices(DWORD* pulcbBufferLen, BYTE* pbBuffer)
pulcbBufferLenDWORD*inout入出力でバッファのバイト長を指定/受け取るポインタ。NULL指定で必要サイズを取得する。
pbBufferBYTE*outサービス一覧データを書き込む出力バッファへのポインタ。NULLでサイズ取得のみ行う。
vtbl 8 HRESULT GetServiceInfoFromTuneXml(LPWSTR bstrTuneXml, LPWSTR* pbstrServiceDescription)
bstrTuneXmlLPWSTRinサービスを特定する選局情報のXML文字列を渡す入力引数。
pbstrServiceDescriptionLPWSTR*out該当サービスの説明文字列を受け取る出力ポインタ。呼出側が解放する。

HSP用 COM定義

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

出力引数: 
#define global IID_IBDA_GuideDataDeliveryService "{C0AFCB73-23E7-4BC6-BAFA-FDC167B4719F}"
#usecom global IBDA_GuideDataDeliveryService IID_IBDA_GuideDataDeliveryService "{}"
#comfunc global IBDA_GuideDataDeliveryService_GetGuideDataType           3 var
#comfunc global IBDA_GuideDataDeliveryService_GetGuideData               4 var,var,var
#comfunc global IBDA_GuideDataDeliveryService_RequestGuideDataUpdate     5
#comfunc global IBDA_GuideDataDeliveryService_GetTuneXmlFromServiceIdx   6 int64,var
#comfunc global IBDA_GuideDataDeliveryService_GetServices                7 var,var
#comfunc global IBDA_GuideDataDeliveryService_GetServiceInfoFromTuneXml  8 wstr,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。