ホーム › Media.DirectShow.Tv › IPBDA_Services

IPBDA_Services

COM

IID944eab37-eed4-4850-afd2-77e7efeb4427継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

Protected Broadcast Device Architecture (PBDA) トランスポートストリーム内の Program and System Information Protocol (PSIP) テーブルから、Protected Broadcast Driver Architecture (PBDA) のサービスレコードを初期化または取得するメソッドを実装します。

メソッド 3

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

vtbl 3 HRESULT Initialize(DWORD size, BYTE* pBuffer)

Protected Broadcast Device Architecture (PBDA) トランスポートストリーム内の Program and System Information Protocol (PSIP) テーブルからサービスレコードを取得するオブジェクトを初期化します。

size	DWORD	in	オブジェクトの初期化に使用するバッファーのサイズを指定します。
pBuffer	BYTE*	in	初期化に使用するサービスデータを格納したバッファーへのポインター。

戻り値

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

vtbl 4 HRESULT GetCountOfRecords(DWORD* pdwVal)

Protected Broadcast Device Architecture (PBDA) トランスポートストリーム内の Program and System Information Protocol (PSIP) テーブルからサービスレコードの数を取得します。

pdwVal

DWORD*

out

サービスレコードの数を受け取ります。

戻り値

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

vtbl 5 HRESULT GetRecordByIndex(DWORD dwRecordIndex, ULONGLONG* pul64ServiceIdx)

Protected Broadcast Device Architecture (PBDA) トランスポートストリーム内の Program and System Information Protocol (PSIP) テーブルから、指定した位置にあるサービスレコードを取得します。

dwRecordIndex	DWORD	in	サービスレコード番号を指定します。0 から始まるインデックスです。 PSIP テーブル内のレコード数を取得するには、IPBDA_Services::GetCountOfRecords メソッドを呼び出します。
pul64ServiceIdx	ULONGLONG*	out	dwRecordIndex で指定された位置にあるサービスレコードを受け取ります。

戻り値

このメソッドが成功した場合は 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_IPBDA_Services "{944EAB37-EED4-4850-AFD2-77E7EFEB4427}"
#usecom global IPBDA_Services IID_IPBDA_Services "{}"
#comfunc global IPBDA_Services_Initialize         3 int,var
#comfunc global IPBDA_Services_GetCountOfRecords  4 var
#comfunc global IPBDA_Services_GetRecordByIndex   5 int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IPBDA_Services "{944EAB37-EED4-4850-AFD2-77E7EFEB4427}"
#usecom global IPBDA_Services IID_IPBDA_Services "{}"
#comfunc global IPBDA_Services_Initialize         3 int,sptr
#comfunc global IPBDA_Services_GetCountOfRecords  4 sptr
#comfunc global IPBDA_Services_GetRecordByIndex   5 int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。