ホーム › Media.MediaPlayer › IWMPClosedCaption2

IWMPClosedCaption2

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IID350ba78b-6bc8-4113-a5f5-312056934eb6継承元IWMPClosedCaption呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl15

公式ドキュメント

IWMPClosedCaption2 インターフェイスは、IWMPClosedCaption インターフェイスを補完するクローズドキャプション用のメソッドを提供します。

メソッド 5

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 15 HRESULT get_SAMILangCount(INT* plCount)

get_SAMILangCount メソッドは、現在の SAMI ファイルがサポートする言語の数を取得します。

plCount

INT*

inout

数を格納する long へのポインター。

戻り値

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されるわけではありません。

戻り値	説明
S_OK	メソッドは成功しました。

解説(Remarks)

このメソッドは、デジタルメディアファイルが開かれるまで使用できません。

Windows Media Player 10 Mobile: このメソッドは常に 0 に設定された long を取得します。

vtbl 16 HRESULT getSAMILangName(INT nIndex, LPWSTR* pbstrName)

getSAMILangName メソッドは、現在の SAMI ファイルがサポートする言語の名前を取得します。

nIndex	INT	in	取得する言語名のインデックスを格納する long。
pbstrName	LPWSTR*	inout	名前を格納する BSTR へのポインター。

戻り値

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されるわけではありません。

戻り値	説明
S_OK	メソッドは成功しました。

解説(Remarks)

SAMI ファイル内の言語は、ファイルに示された順序で、ゼロから始まるインデックスが付けられます。

このメソッドは、デジタルメディアファイルが開かれるまで使用できません。

Windows Media Player 10 Mobile: このメソッドは常に空の文字列を格納した BSTR を取得します。

vtbl 17 HRESULT getSAMILangID(INT nIndex, INT* plLangID)

getSAMILangID メソッドは、現在の SAMI ファイルがサポートする言語のロケール識別子 (LCID) を取得します。

nIndex	INT	in	インデックスを格納する long。
plLangID	INT*	inout	取得する LCID のインデックスを格納する long へのポインター。

戻り値

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されるわけではありません。

戻り値	説明
S_OK	メソッドは成功しました。

解説(Remarks)

SAMI ファイル内の言語は、ファイルに示された順序で、ゼロから始まるインデックスが付けられます。

このメソッドは、デジタルメディアファイルが開かれるまで使用できません。

Windows Media Player 10 Mobile: このメソッドは常に 0 に設定された long を取得し、E_INVALIDARG の HRESULT を返します。

vtbl 18 HRESULT get_SAMIStyleCount(INT* plCount)

get_SAMIStyleCount メソッドは、現在の SAMI ファイルがサポートするスタイルの数を取得します。

plCount

INT*

inout

数を格納する long へのポインター。

戻り値

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されるわけではありません。

戻り値	説明
S_OK	メソッドは成功しました。

解説(Remarks)

このメソッドは、デジタルメディアファイルが開かれるまで使用できません。

Windows Media Player 10 Mobile: このメソッドは常に 0 に設定された long を取得します。

vtbl 19 HRESULT getSAMIStyleName(INT nIndex, LPWSTR* pbstrName)

getSAMIStyleName メソッドは、現在の SAMI ファイルがサポートするスタイルの名前を取得します。

nIndex	INT	in	取得するスタイル名のインデックスを格納する long。
pbstrName	LPWSTR*	inout	SAMI ファイルで指定されたスタイルの名前を格納する BSTR へのポインター。

戻り値

このメソッドは HRESULT を返します。指定できる値には、以下の表に示すものが含まれますが、これらに限定されるわけではありません。

戻り値	説明
S_OK	メソッドは成功しました。

解説(Remarks)

SAMI ファイル内のスタイルは、ファイルに示された順序で、ゼロから始まるインデックスが付けられます。

このメソッドは、デジタルメディアファイルが開かれるまで使用できません。

Windows Media Player 10 Mobile: このメソッドは常に空の文字列を格納した BSTR を取得します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IWMPClosedCaption2 "{350BA78B-6BC8-4113-A5F5-312056934EB6}"
#usecom global IWMPClosedCaption2 IID_IWMPClosedCaption2 "{}"
#comfunc global IWMPClosedCaption2_get_SAMILangCount   15 var
#comfunc global IWMPClosedCaption2_getSAMILangName     16 int,var
#comfunc global IWMPClosedCaption2_getSAMILangID       17 int,var
#comfunc global IWMPClosedCaption2_get_SAMIStyleCount  18 var
#comfunc global IWMPClosedCaption2_getSAMIStyleName    19 int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IWMPClosedCaption2 "{350BA78B-6BC8-4113-A5F5-312056934EB6}"
#usecom global IWMPClosedCaption2 IID_IWMPClosedCaption2 "{}"
#comfunc global IWMPClosedCaption2_get_SAMILangCount   15 sptr
#comfunc global IWMPClosedCaption2_getSAMILangName     16 int,sptr
#comfunc global IWMPClosedCaption2_getSAMILangID       17 int,sptr
#comfunc global IWMPClosedCaption2_get_SAMIStyleCount  18 sptr
#comfunc global IWMPClosedCaption2_getSAMIStyleName    19 int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。