IIsdbDigitalCopyControlDescriptor
COM公式ドキュメント
ISDB (Integrated Services Digital Broadcasting) のデジタルコピー制御記述子 (digital copy control descriptor) からデータを取得するメソッドを実装します。
メソッド 5
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
ISDB (Integrated Services Digital Broadcasting) のデジタルコピー制御記述子を識別するタグを取得します。
| pbVal | BYTE* | out | タグ値を受け取ります。デジタルコピー制御記述子の場合、この値は 0xC1 です。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
ISDB (Integrated Services Digital Broadcasting) のデジタルコピー制御記述子の本体長をバイト単位で取得します。
| pbVal | BYTE* | out | 記述子の長さを受け取ります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
ISDB (Integrated Services Digital Broadcasting) のデジタルコピー制御記述子からコピー制御データを取得します。
| pbDigitalRecordingControlData | BYTE* | out | コピー制御の種別を示す 2 ビットのコードを受け取ります。このコードは次のいずれかの値を取ります。
| ||||||||||
| pbCopyControlType | BYTE* | out | デジタルコピーの出力制御オプションを定義するデータを受け取ります。
| ||||||||||
| pbAPSControlData | BYTE* | out | pbCopyControlType パラメーターの値が 01 のときに、アナログコピーの出力制御オプションを定義するデータを受け取ります。
| ||||||||||
| pbMaximumBitrate | BYTE* | out | トランスポートストリームパケットの最大伝送レートを 250 kbps 単位で受け取ります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
ISDB (Integrated Services Digital Broadcasting) のデジタルコピー制御記述子内のレコード数を取得します。
| pbVal | BYTE* | out | レコード数を受け取ります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
ISDB (Integrated Services Digital Broadcasting) のデジタルコピー制御記述子内の指定されたコンポーネントからコピー制御データを取得します。
| bRecordIndex | BYTE | in | コンポーネントのレコード番号を 0 から始まるインデックスで指定します。デジタルコピー制御記述子内のレコード数を取得するには、IIsdbDigitalCompyControlDescriptor::GetCountOfRecords メソッドを呼び出します。 | ||||||||||
| pbComponentTag | BYTE* | out | コンポーネントを識別するタグを受け取ります。この値は、stream identifier descriptor (ストリーム識別記述子) および component descriptor (コンポーネント記述子) 内のコンポーネントタグと同じです。 | ||||||||||
| pbDigitalRecordingControlData | BYTE* | out | コピー制御の種別を示す 2 ビットのコードを受け取ります。このコードは次のいずれかの値を取ります。
| ||||||||||
| pbCopyControlType | BYTE* | out | デジタルコピーの出力制御オプションを定義するデータを受け取ります。
| ||||||||||
| pbAPSControlData | BYTE* | out | pbCopyControlType パラメーターの値が 01 のときに、アナログコピーの出力制御オプションを定義するデータを受け取ります。
| ||||||||||
| pbMaximumBitrate | BYTE* | out | トランスポートストリームパケットの最大伝送レートを 250 kbps 単位で受け取ります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IIsdbDigitalCopyControlDescriptor "{1A28417E-266A-4BB8-A4BD-D782BCFB8161}" #usecom global IIsdbDigitalCopyControlDescriptor IID_IIsdbDigitalCopyControlDescriptor "{}" #comfunc global IIsdbDigitalCopyControlDescriptor_GetTag 3 var #comfunc global IIsdbDigitalCopyControlDescriptor_GetLength 4 var #comfunc global IIsdbDigitalCopyControlDescriptor_GetCopyControl 5 var,var,var,var #comfunc global IIsdbDigitalCopyControlDescriptor_GetCountOfRecords 6 var #comfunc global IIsdbDigitalCopyControlDescriptor_GetRecordCopyControl 7 int,var,var,var,var,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IIsdbDigitalCopyControlDescriptor "{1A28417E-266A-4BB8-A4BD-D782BCFB8161}" #usecom global IIsdbDigitalCopyControlDescriptor IID_IIsdbDigitalCopyControlDescriptor "{}" #comfunc global IIsdbDigitalCopyControlDescriptor_GetTag 3 sptr #comfunc global IIsdbDigitalCopyControlDescriptor_GetLength 4 sptr #comfunc global IIsdbDigitalCopyControlDescriptor_GetCopyControl 5 sptr,sptr,sptr,sptr #comfunc global IIsdbDigitalCopyControlDescriptor_GetCountOfRecords 6 sptr #comfunc global IIsdbDigitalCopyControlDescriptor_GetRecordCopyControl 7 int,sptr,sptr,sptr,sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。