Win32 API 日本語リファレンス
ホーム › Media.MediaFoundation › IMFTimedTextNotify

IMFTimedTextNotify

COM
📘 Microsoft Learn (日本語) · English
IIDdf6b87b6-ce12-45db-aba7-432fe054e57d継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

Microsoft Media Foundation の Timed Text 通知のコールバックを定義するインターフェイスです。

メソッド 7

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

vtbl 3 void TrackAdded(DWORD trackId)

テキスト トラックが追加されたときに呼び出されます。

trackIdDWORDin追加されたトラックの識別子です。
vtbl 4 void TrackRemoved(DWORD trackId)

テキスト トラックが削除されたときに呼び出されます。

trackIdDWORDin削除されたトラックの識別子です。
vtbl 5 void TrackSelected(DWORD trackId, BOOL selected)

トラックが選択または選択解除されたときに呼び出されます。

trackIdDWORDin選択または選択解除されたトラックの識別子です。
selectedBOOLinトラックが選択された場合は TRUE。トラックが選択解除された場合は FALSE。
vtbl 6 void TrackReadyStateChanged(DWORD trackId)
trackIdDWORDin準備状態(ready state)が変化したトラックを識別するID。
vtbl 7 void Error(MF_TIMED_TEXT_ERROR_CODE errorCode, HRESULT extendedErrorCode, DWORD sourceTrackId)

テキスト トラックでエラーが発生したときに呼び出されます。

errorCodeMF_TIMED_TEXT_ERROR_CODEin直近のエラーを表す MF_TIMED_TEXT_ERROR_CODE です。
extendedErrorCodeHRESULTin直近のエラーの拡張エラー コードです。
sourceTrackIdDWORDinエラーが発生したトラックの識別子です。
vtbl 8 void Cue(MF_TIMED_TEXT_CUE_EVENT cueEvent, DOUBLE currentTime, IMFTimedTextCue* cue)

テキスト トラックでキュー イベントが発生したときに呼び出されます。

cueEventMF_TIMED_TEXT_CUE_EVENTin発生したイベントの種類を指定する値です。
currentTimeDOUBLEinキュー イベントが発生した時点の現在時刻です。
cueIMFTimedTextCue*inoptionalキューを表す IMFTimedTextCue オブジェクトです。
vtbl 9 void Reset()

timed-text-notify オブジェクトをリセットします。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IMFTimedTextNotify "{DF6B87B6-CE12-45DB-ABA7-432FE054E57D}"
#usecom global IMFTimedTextNotify IID_IMFTimedTextNotify "{}"
#comfunc global IMFTimedTextNotify_TrackAdded              3 int
#comfunc global IMFTimedTextNotify_TrackRemoved            4 int
#comfunc global IMFTimedTextNotify_TrackSelected           5 int,int
#comfunc global IMFTimedTextNotify_TrackReadyStateChanged  6 int
#comfunc global IMFTimedTextNotify_Error                   7 int,int,int
#comfunc global IMFTimedTextNotify_Cue                     8 int,double,sptr
#comfunc global IMFTimedTextNotify_Reset                   9
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。