IMSVidStreamBufferV2SourceEvent
COMIDispatch (デュアル)comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
Video Control 内にラップされた Stream Buffer Engine バージョン 2 (SBE2) ソースフィルターのイベントシステムを実装します。各イベントは、DirectShow グラフ内で SBE2 ソースフィルターが受信するイベントに対応します。
解説(Remarks)
このインターフェースのインターフェース識別子 (IID) を宣言するには、__uuidof 演算子を使用します: __uuidof(IMSVidStreamBufferV2SourceEvent)。
メソッド 9
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
SBE2 ソースフィルターが STREAMBUFFER_EC_RATE_CHANGED イベント(再生レートが変化したことを示す)を受信したときに発生します。
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
SBE2 ソースフィルターが STREAMBUFFER_EC_TIMEHOLE イベント(録画コンテンツ内のギャップに再生が到達したことを示す)を受信したときに発生します。
| StreamOffsetMS | INT | in | コンテンツの開始を基準とした、ギャップの開始時刻(ミリ秒単位)。 |
| SizeMS | INT | in | ギャップの長さ(ミリ秒単位)。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
SBE2 ソースフィルターが STREAMBUFFER_EC_STALE_DATA_READ イベント(MSVidStreamBufferSource オブジェクトが削除対象としてマークされた一時録画ファイルから読み取ったことを示す)を受信したときに発生します。
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
SBE2 ソースフィルターが STREAMBUFFER_EC_CONTENT_BECOMING_STALE イベント(ストリームバッファーソースが、あらかじめ設定されたファイル数を超えてストリームバッファーシンクから遅れていることを示す)を受信したときに発生します。詳細については、IStreamBufferConfigure::GetBackingFileCount を参照してください。
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
SBE2 ソースフィルターが STREAMBUFFER_EC_STALE_FILE_DELETED イベント(一時ファイルが削除されたことを示す)を受信したときに発生します。
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
SBE2 ソースフィルターが STREAMBUFFER_EC_RATE_CHANGED イベント(再生レートが変化したことを示す)を受信したときに発生します。
| qwNewRate | DOUBLE | in | 新しい再生レートを 1,000 倍した値。 |
| qwOldRate | DOUBLE | in | 以前の再生レートを 1,000 倍した値。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
SBE2 ソースフィルターが、EVENTID_DTFilterRatingChange イベント以外の、IBroadcastEvent インターフェースを通じて発生したいずれかのイベントを受信したときに発生します。
| Guid | LPWSTR | in | イベントを識別する GUID を含む BSTR オブジェクト。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
SBE2 ソースフィルターが、IBroadcastEventEx::FireEx の呼び出しによって発生したいずれかのイベントを受信したときに発生します。
| Guid | LPWSTR | in | イベントを識別する GUID を含む BSTR オブジェクト。 |
| Param1 | DWORD | in | 実装依存の 1 番目のパラメーターを指定します。 |
| Param2 | DWORD | in | 実装依存の 2 番目のパラメーターを指定します。 |
| Param3 | DWORD | in | 実装依存の 3 番目のパラメーターを指定します。 |
| Param4 | DWORD | in | 実装依存の 4 番目のパラメーターを指定します。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
SBE2 ソースフィルターが STREAMBUFFER_EC_PRIMARY_AUDIO イベント(IMSVidStreamBufferSourceEvent3 インターフェースを通じて発生し、SBE が主に音声データを処理していることを示す)を受信したときに発生します。
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
STREAMBUFFER_EC_PRIMARY_AUDIO イベントは、映像サンプルが低いフレームレートでキャプチャされた場合に送信されます。このイベントは通常、DVB stream 上の音声サービスで発生しますが、映像のキャプチャまたはエンコードに関する問題を示している場合もあります。
このイベントは、Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 以降に適用されます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IMSVidStreamBufferV2SourceEvent "{49C771F9-41B2-4CF7-9F9A-A313A8F6027E}"
#usecom global IMSVidStreamBufferV2SourceEvent IID_IMSVidStreamBufferV2SourceEvent "{}"
#comfunc global IMSVidStreamBufferV2SourceEvent_RatingsChanged 8
#comfunc global IMSVidStreamBufferV2SourceEvent_TimeHole 9 int,int
#comfunc global IMSVidStreamBufferV2SourceEvent_StaleDataRead 10
#comfunc global IMSVidStreamBufferV2SourceEvent_ContentBecomingStale 11
#comfunc global IMSVidStreamBufferV2SourceEvent_StaleFileDeleted 12
#comfunc global IMSVidStreamBufferV2SourceEvent_RateChange 13 double,double
#comfunc global IMSVidStreamBufferV2SourceEvent_BroadcastEvent 14 wstr
#comfunc global IMSVidStreamBufferV2SourceEvent_BroadcastEventEx 15 wstr,int,int,int,int
#comfunc global IMSVidStreamBufferV2SourceEvent_ContentPrimarilyAudio 16
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。