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

IDvbMultilingualServiceNameDescriptor

COM
📘 Microsoft Learn (日本語) · English
IID2d80433b-b32c-47ef-987f-e78ebb773e34継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

Digital Video Broadcast (DVB) の多言語サービス名記述子からデータを取得するメソッドを実装します。多言語サービス名記述子は、サービス提供者名およびサービス名を、1つ以上の言語のテキスト形式で提供します。

メソッド 6

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

vtbl 3 HRESULT GetTag(BYTE* pbVal)

Digital Video Broadcast (DVB) の多言語サービス名記述子を識別するタグを取得します。

pbValBYTE*outサービスリスト記述子のタグを受け取ります。多言語サービス名記述子の場合、この値は通常 0x5D です。

戻り値

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

vtbl 4 HRESULT GetLength(BYTE* pbVal)

Digital Video Broadcast (DVB) の多言語サービス名記述子から descriptor_length フィールドの値を取得します。

pbValBYTE*outdescriptor_length フィールドの値を受け取ります。

戻り値

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

vtbl 5 HRESULT GetCountOfRecords(BYTE* pbVal)

Digital Video Broadcast (DVB) の多言語サービス名記述子に含まれるサービスレコードの数を取得します。

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

戻り値

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

vtbl 6 HRESULT GetRecordLangId(BYTE bRecordIndex, DWORD* ulVal)

Digital Video Broadcast (DVB) の多言語サービス名記述子から、3文字の ISO 639 言語コードを取得します。この言語コードは、記述子内のテキストに使用される言語を識別します。

bRecordIndexBYTEinサービスレコード番号を指定します。0 から始まるインデックスです。多言語サービス名記述子に含まれるレコードの数を取得するには、IDvbMultilingualServiceNameDescriptor::GetCountOfRecords メソッドを呼び出します。
ulValDWORD*out言語コードを受け取るバッファーへのポインター。言語コードの一覧については、こちらのドキュメントを参照してください。

戻り値

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

vtbl 7 HRESULT GetRecordServiceProviderNameW(BYTE bRecordIndex, DVB_STRCONV_MODE convMode, LPWSTR* pbstrName)

Digital Video Broadcast (DVB) の多言語サービス名記述子から、サービス提供者名を文字列形式で取得します。

bRecordIndexBYTEinサービスレコード番号を指定します。0 から始まるインデックスです。logical channel descriptor に含まれるレコードの数を取得するには、IDvbMultilingualServiceNameDescriptor::GetCountOfRecords メソッドを呼び出します。
convModeDVB_STRCONV_MODEin

使用する文字列変換モードを指定します。このパラメーターには次のいずれかの値を指定できます。

pbstrNameLPWSTR*outサービス提供者名の文字列を受け取るメモリブロックへのポインター。このメモリの解放は呼び出し側が行います。

戻り値

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

vtbl 8 HRESULT GetRecordServiceNameW(BYTE bRecordIndex, DVB_STRCONV_MODE convMode, LPWSTR* pbstrName)

Digital Video Broadcast (DVB) の多言語サービス名記述子から、サービス名を文字列形式で取得します。

bRecordIndexBYTEinサービスレコード番号を指定します。0 から始まるインデックスです。logical channel descriptor に含まれるレコードの数を取得するには、IDvbMultilingualServiceNameDescriptor::GetCountOfRecords メソッドを呼び出します。
convModeDVB_STRCONV_MODEin

使用する文字列変換モードを指定します。このパラメーターには次のいずれかの値を指定できます。

pbstrNameLPWSTR*outサービス名の文字列を受け取るバッファーへのポインター。このメモリの解放は呼び出し側が行います。

戻り値

このメソッドが成功した場合は 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_IDvbMultilingualServiceNameDescriptor "{2D80433B-B32C-47EF-987F-E78EBB773E34}"
#usecom global IDvbMultilingualServiceNameDescriptor IID_IDvbMultilingualServiceNameDescriptor "{}"
#comfunc global IDvbMultilingualServiceNameDescriptor_GetTag                         3 var
#comfunc global IDvbMultilingualServiceNameDescriptor_GetLength                      4 var
#comfunc global IDvbMultilingualServiceNameDescriptor_GetCountOfRecords              5 var
#comfunc global IDvbMultilingualServiceNameDescriptor_GetRecordLangId                6 int,var
#comfunc global IDvbMultilingualServiceNameDescriptor_GetRecordServiceProviderNameW  7 int,int,var
#comfunc global IDvbMultilingualServiceNameDescriptor_GetRecordServiceNameW          8 int,int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。