IIsdbCAContractInformationDescriptor
COM公式ドキュメント
Integrated Services Digital Broadcasting (ISDB) の限定受信 (CA) 契約情報記述子からデータを取得するメソッドを実装します。
メソッド 9
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
Integrated Services Digital Broadcasting (ISDB) の限定受信 (CA) 契約情報記述子を識別するタグを取得します。
| pbVal | BYTE* | out | タグ値を受け取ります。ISDB CA 契約情報記述子の場合、この値は 0xCB です。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Integrated Services Digital Broadcasting (ISDB) の限定受信 (CA) 契約情報記述子の本体の長さをバイト単位で取得します。
| pbVal | BYTE* | out | 記述子の長さを受け取ります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Integrated Services Digital Broadcasting (ISDB) の限定受信 (CA) 契約情報記述子から CA_system_id フィールドの値を取得します。このフィールドは、契約情報に関連付けられた限定受信システムを識別します。
| pwVal | WORD* | out | 限定受信システムの識別子を受け取ります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Integrated Services Digital Broadcasting (ISDB) の限定受信 (CA) 契約情報記述子から CA_unit_id フィールドの値を取得します。このフィールドは、コンポーネントが属する課金単位または非課金単位を識別します。
| pbVal | BYTE* | out | 限定受信の単位識別子を受け取ります。次のいずれかの値になります。
|
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Integrated Services Digital Broadcasting (ISDB) の限定受信 (CA) 契約情報記述子に含まれるレコードの数を取得します。
| pbVal | BYTE* | out | レコードの数を受け取ります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Integrated Services Digital Broadcasting (ISDB) の限定受信 (CA) 契約情報記述子から、コンポーネントレコードを識別する放送事業者定義のタグを取得します。
| bRecordIndex | BYTE | in | タグを含むコンポーネントレコードの 0 から始まるインデックス。コンポーネントの数を取得するには、IIsdbCAContractInformationDescriptor::GetCountOfRecords を呼び出します。 |
| pbVal | BYTE* | out | コンポーネントレコード ID タグを受け取ります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Integrated Services Digital Broadcasting (ISDB) の限定受信 (CA) 契約情報記述子から contract_verification_info フィールドの長さを取得します。
| pbVal | BYTE* | out | フィールドの長さを受け取ります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Integrated Services Digital Broadcasting (ISDB) の限定受信 (CA) 契約情報記述子内の contract_verification_info フィールドからデータを取得します。このフィールドは、限定受信サービスの許可された用途を判別するために使用されます。
| bBufLength | BYTE | in | 契約検証データを保持するバッファーの長さを指定します。 |
| pbBuf | BYTE* | out | 契約検証データを受け取るバッファーへのポインター。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
contract_verification_info フィールドは、サービス、またはサービスを構成する ES グループが、視聴 (録画) のために予約可能かどうかを確認するために使用されます。contract_verification_info フィールドが event information table (EIT) に現れる場合、対象のイベントがフラット型かティア型か、イベントを構成する ES グループか、pay-per-view (PPV) イベントか、あるいは PPV イベントを構成する ES グループかを判別するためにも使用されます。イベントが PPV イベントまたは PPV イベントを構成する ES グループである場合、この記述子は視聴料金および録画要求情報を判別するために使用されます。
Integrated Services Digital Broadcasting (ISDB) の限定受信 (CA) 契約情報記述子から fee_name フィールドの値を Unicode テキスト形式で取得します。このフィールドは、記述対象の ES グループに対する料金を示します。
| convMode | DVB_STRCONV_MODE | in | 使用する文字列変換モードを指定します。このパラメーターには次のいずれかの値を指定できます。 |
| pbstrName | LPWSTR* | out | 料金名を受け取るバッファーへのポインター。このメモリを解放する責任は呼び出し側にあります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IIsdbCAContractInformationDescriptor "{08E18B25-A28F-4E92-821E-4FCED5CC2291}" #usecom global IIsdbCAContractInformationDescriptor IID_IIsdbCAContractInformationDescriptor "{}" #comfunc global IIsdbCAContractInformationDescriptor_GetTag 3 var #comfunc global IIsdbCAContractInformationDescriptor_GetLength 4 var #comfunc global IIsdbCAContractInformationDescriptor_GetCASystemId 5 var #comfunc global IIsdbCAContractInformationDescriptor_GetCAUnitId 6 var #comfunc global IIsdbCAContractInformationDescriptor_GetCountOfRecords 7 var #comfunc global IIsdbCAContractInformationDescriptor_GetRecordComponentTag 8 int,var #comfunc global IIsdbCAContractInformationDescriptor_GetContractVerificationInfoLength 9 var #comfunc global IIsdbCAContractInformationDescriptor_GetContractVerificationInfo 10 int,var #comfunc global IIsdbCAContractInformationDescriptor_GetFeeNameW 11 int,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IIsdbCAContractInformationDescriptor "{08E18B25-A28F-4E92-821E-4FCED5CC2291}" #usecom global IIsdbCAContractInformationDescriptor IID_IIsdbCAContractInformationDescriptor "{}" #comfunc global IIsdbCAContractInformationDescriptor_GetTag 3 sptr #comfunc global IIsdbCAContractInformationDescriptor_GetLength 4 sptr #comfunc global IIsdbCAContractInformationDescriptor_GetCASystemId 5 sptr #comfunc global IIsdbCAContractInformationDescriptor_GetCAUnitId 6 sptr #comfunc global IIsdbCAContractInformationDescriptor_GetCountOfRecords 7 sptr #comfunc global IIsdbCAContractInformationDescriptor_GetRecordComponentTag 8 int,sptr #comfunc global IIsdbCAContractInformationDescriptor_GetContractVerificationInfoLength 9 sptr #comfunc global IIsdbCAContractInformationDescriptor_GetContractVerificationInfo 10 int,sptr #comfunc global IIsdbCAContractInformationDescriptor_GetFeeNameW 11 int,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。