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

IDvbExtendedEventDescriptor

COM
📘 Microsoft Learn (日本語) · English
IIDc9b22eca-85f4-499f-b1db-efa93a91ee57継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

Digital Video Broadcast (DVB) 拡張イベント記述子からデータを取得するメソッドを実装します。

メソッド 11

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

vtbl 3 HRESULT GetTag(BYTE* pbVal)

Digital Video Broadcast (DVB) 拡張イベント記述子を識別するタグを取得します。

pbValBYTE*out識別タグを受け取ります。DVB 拡張イベント記述子の場合、この値は "0x4E" です。

戻り値

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

vtbl 4 HRESULT GetLength(BYTE* pbVal)

Digital Video Broadcast (DVB) 拡張イベント記述子の本体長を取得します。

pbValBYTE*outイベント記述子の長さを受け取ります。

戻り値

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

vtbl 5 HRESULT GetDescriptorNumber(BYTE* pbVal)

Digital Video Broadcast (DVB) 拡張イベント記述子から記述子番号を取得します。

pbValBYTE*out記述子番号を受け取ります。

戻り値

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

vtbl 6 HRESULT GetLastDescriptorNumber(BYTE* pbVal)

Digital Video Broadcast (DVB) 拡張イベント記述子から、この記述子に関連付けられた最後の記述子の番号を取得します。

pbValBYTE*out最後の記述子番号を受け取ります。

戻り値

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

vtbl 7 HRESULT GetLanguageCode(BYTE* pszCode)

Digital Video Broadcast (DVB) 拡張イベント記述子から、3文字の ISO 639 言語コードを取得します。

pszCodeBYTE*out言語コードを受け取るバッファーへのポインター。このメモリの解放は呼び出し側が行います。

戻り値

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

vtbl 8 HRESULT GetCountOfRecords(BYTE* pbVal)

Digital Video Broadcast (DVB) 拡張イベント記述子内の項目レコード数を取得します。

pbValBYTE*out項目レコード数を受け取ります。

戻り値

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

vtbl 9 HRESULT GetRecordItemW(BYTE bRecordIndex, DVB_STRCONV_MODE convMode, LPWSTR* pbstrDesc, LPWSTR* pbstrItem)

Digital Video Broadcast (DVB) 拡張イベント記述子から、項目と記述子を Unicode 文字列形式で取得します。

bRecordIndexBYTEin項目レコード番号を、0 から始まるインデックスで指定します。拡張イベント記述子内のレコード数を取得するには、IDvbExtendedEventDescriptor::GetCountOfRecords メソッドを呼び出します。
convModeDVB_STRCONV_MODEin

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

pbstrDescLPWSTR*out項目の説明を受け取るバッファーへのポインター。このメモリの解放は呼び出し側が行います。
pbstrItemLPWSTR*out項目テキストを受け取るバッファーへのポインター。このメモリの解放は呼び出し側が行います。

戻り値

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

vtbl 10 HRESULT GetConcatenatedItemW(IDvbExtendedEventDescriptor* pFollowingDescriptor, DVB_STRCONV_MODE convMode, LPWSTR* pbstrDesc, LPWSTR* pbstrItem)

現在の Digital Video Broadcast (DVB) 拡張イベント記述子内の項目のバイト列を、次の DVB 拡張イベント記述子内の項目のバイト列と連結し、連結したデータを Unicode 文字列として返します。

pFollowingDescriptorIDvbExtendedEventDescriptor*in現在の記述子に関連付けられた次の DVB 拡張イベント記述子の IDvbExtendedEventDescriptor インターフェースへのポインター。
convModeDVB_STRCONV_MODEin

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

pbstrDescLPWSTR*out連結された項目記述子を受け取るバッファーへのポインター。このメモリの解放は呼び出し側が行います。
pbstrItemLPWSTR*out連結された項目文字列を受け取るバッファーへのポインター。このメモリの解放は呼び出し側が行います。

戻り値

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

vtbl 11 HRESULT GetTextW(DVB_STRCONV_MODE convMode, LPWSTR* pbstrText)

Digital Video Broadcast (DVB) 拡張イベント記述子から、項目を説明するテキストを文字列形式で取得します。

convModeDVB_STRCONV_MODEin

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

pbstrTextLPWSTR*outイベントの説明を受け取るバッファーへのポインター。このメモリの解放は呼び出し側が行います。

戻り値

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

vtbl 12 HRESULT GetConcatenatedTextW(IDvbExtendedEventDescriptor* FollowingDescriptor, DVB_STRCONV_MODE convMode, LPWSTR* pbstrText)

Digital Video Broadcast (DVB) 拡張イベント記述子について、現在の項目のテキスト説明と次の項目のテキスト説明(いずれも Unicode 形式)を連結したものを取得します。

FollowingDescriptorIDvbExtendedEventDescriptor*in現在のイベント記述子に関連付けられた次の拡張イベント記述子の IDvbExtendedEventDescriptor インターフェースへのポインター。
convModeDVB_STRCONV_MODEin

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

pbstrTextLPWSTR*out連結された項目テキストを受け取るバッファーへのポインター。このメモリの解放は呼び出し側が行います。

戻り値

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

vtbl 13 HRESULT GetRecordItemRawBytes(BYTE bRecordIndex, BYTE** ppbRawItem, BYTE* pbItemLength)

Digital Video Broadcast (DVB) 拡張イベント記述子の現在の項目から生データを取得します。

bRecordIndexBYTEin項目レコード番号を、0 から始まるインデックスで指定します。拡張イベント記述子内のレコード数を取得するには、IDvbExtendedEventDescriptor::GetCountOfRecords メソッドを呼び出します。
ppbRawItemBYTE**out項目データを受け取るバッファーへのポインター。このメモリの解放は呼び出し側が行います。
pbItemLengthBYTE*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_IDvbExtendedEventDescriptor "{C9B22ECA-85F4-499F-B1DB-EFA93A91EE57}"
#usecom global IDvbExtendedEventDescriptor IID_IDvbExtendedEventDescriptor "{}"
#comfunc global IDvbExtendedEventDescriptor_GetTag                   3 var
#comfunc global IDvbExtendedEventDescriptor_GetLength                4 var
#comfunc global IDvbExtendedEventDescriptor_GetDescriptorNumber      5 var
#comfunc global IDvbExtendedEventDescriptor_GetLastDescriptorNumber  6 var
#comfunc global IDvbExtendedEventDescriptor_GetLanguageCode          7 var
#comfunc global IDvbExtendedEventDescriptor_GetCountOfRecords        8 var
#comfunc global IDvbExtendedEventDescriptor_GetRecordItemW           9 int,int,var,var
#comfunc global IDvbExtendedEventDescriptor_GetConcatenatedItemW     10 sptr,int,var,var
#comfunc global IDvbExtendedEventDescriptor_GetTextW                 11 int,var
#comfunc global IDvbExtendedEventDescriptor_GetConcatenatedTextW     12 sptr,int,var
#comfunc global IDvbExtendedEventDescriptor_GetRecordItemRawBytes    13 int,var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。