IDvbSubtitlingDescriptor
COM公式ドキュメント
Digital Video Broadcast (DVB) の subtitling 記述子からデータを取得するメソッドを実装します。
メソッド 7
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
Digital Video Broadcast (DVB) の subtitling 記述子のタグを取得します。
| pbVal | BYTE* | out | subtitling 記述子のタグを受け取ります。subtitling 記述子の場合、このタグの値は "0x59" です。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Digital Video Broadcast (DVB) の subtitling 記述子の本体長を取得します。
| pbVal | BYTE* | out | 記述子のバイト数を受け取ります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Digital Video Broadcast (DVB) の subtitling 記述子に含まれる subtitling レコードの数を取得します。
| pbVal | BYTE* | out | subtitling レコードの数を返します。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Digital Video Broadcast (DVB) の subtitling 記述子から 3 文字の ISO 639 言語コードを取得します。このコードは字幕に使用される言語を識別します。
| bRecordIndex | BYTE | in | 返す記述子の 0 から始まるインデックス。記述子の数を取得するには、IDvbSubtitlingDescriptor::GetCountOfRecords を呼び出します。 |
| pulVal | DWORD* | out | 言語コードを受け取るバッファーへのポインター。言語コードの一覧については、こちらのドキュメントを参照してください。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
DVB の subtitling 記述子から subtitling コンポーネントの種類を取得します。
| bRecordIndex | BYTE | in | 返す記述子の 0 から始まるインデックス。記述子の数を取得するには、IDvbSubtitlingDescriptor::GetCountOfRecords を呼び出します。 | ||||||||||||||||||||||||||||||||||||
| pbVal | BYTE* | out | subtitling コンポーネントの種類コードを受け取ります。次のいずれかの値になります。
|
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Digital Video Broadcast (DVB) の subtitling 記述子の composition page 識別子を取得します。
| bRecordIndex | BYTE | in | 返す記述子の 0 から始まるインデックス。記述子の数を取得するには、IDvbSubtitlingDescriptor::GetCountOfRecords を呼び出します。 |
| pwVal | WORD* | out | composition page 識別子を受け取ります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
composition page 識別子は、字幕画面のデータ構造を定義する subtitling セグメント、すなわち page composition セグメントおよび region composition セグメントにおいて、少なくとも通知されます。また、composition が依存するデータを含むセグメントで追加的に通知される場合もあります。
Digital Video Broadcast (DVB) の subtitling 記述子の ancillary page 識別子を取得します。
| bRecordIndex | BYTE | in | 返す記述子の 0 から始まるインデックス。記述子の数を取得するには、IDvbSubtitlingDescriptor::GetCountOfRecords を呼び出します。 |
| pwVal | WORD* | out | ancillary page 識別子を受け取ります。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
subtitling 記述子に ancillary page がない場合、記述子の ancillary_page_id フィールドと composition_page_id フィールドの値は同一になります。
ancillary_page_id が composition セグメントで通知されることはありません。color lookup table (CLUT) 定義セグメント、object セグメント、またはその他の種類のセグメントで通知される場合があります。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IDvbSubtitlingDescriptor "{9B25FE1D-FA23-4E50-9784-6DF8B26F8A49}" #usecom global IDvbSubtitlingDescriptor IID_IDvbSubtitlingDescriptor "{}" #comfunc global IDvbSubtitlingDescriptor_GetTag 3 var #comfunc global IDvbSubtitlingDescriptor_GetLength 4 var #comfunc global IDvbSubtitlingDescriptor_GetCountOfRecords 5 var #comfunc global IDvbSubtitlingDescriptor_GetRecordLangId 6 int,var #comfunc global IDvbSubtitlingDescriptor_GetRecordSubtitlingType 7 int,var #comfunc global IDvbSubtitlingDescriptor_GetRecordCompositionPageID 8 int,var #comfunc global IDvbSubtitlingDescriptor_GetRecordAncillaryPageID 9 int,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IDvbSubtitlingDescriptor "{9B25FE1D-FA23-4E50-9784-6DF8B26F8A49}" #usecom global IDvbSubtitlingDescriptor IID_IDvbSubtitlingDescriptor "{}" #comfunc global IDvbSubtitlingDescriptor_GetTag 3 sptr #comfunc global IDvbSubtitlingDescriptor_GetLength 4 sptr #comfunc global IDvbSubtitlingDescriptor_GetCountOfRecords 5 sptr #comfunc global IDvbSubtitlingDescriptor_GetRecordLangId 6 int,sptr #comfunc global IDvbSubtitlingDescriptor_GetRecordSubtitlingType 7 int,sptr #comfunc global IDvbSubtitlingDescriptor_GetRecordCompositionPageID 8 int,sptr #comfunc global IDvbSubtitlingDescriptor_GetRecordAncillaryPageID 9 int,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。