ISBE2Crossbar
COM公式ドキュメント
Stream Buffer Engine (SBE) バージョン 2 (SBE2) の Stream Buffer Source フィルターに対するクロスバー機能を定義します。
解説(Remarks)
このインターフェイスのインターフェイス識別子 (IID) を宣言するには、__uuidof 演算子を使用します: __uuidof(ISBE2Crossbar)。
メソッド 4
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
Stream Buffer Source フィルター内のクロスバーについて、プロファイル既定モードとストリーム既定モードを有効または無効にします。
| DefaultFlags | DWORD | in | クロスバーの既定モードを指定します。次の値の任意の組み合わせを指定できます。
|
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
ストリーム既定モードでは、SBE はまず Windows Media Center の TV 設定を調べて、優先言語が設定されているかどうかを判断します。優先言語が設定されている場合:
- 優先言語のオーディオストリームが存在する場合、SBE はそのオーディオストリームを出力します。
- 優先言語のオーディオストリームが存在しない場合、SBE は既定のオーディオストリームを出力します。既定のオーディオストリームは、ストリームのキャプチャ時に設定されます。
- オペレーティングシステムのロケールの言語のオーディオストリームが存在する場合、SBE はそのオーディオストリームを出力します。
- それ以外の場合、SBE は既定のオーディオストリームを出力します。
現在読み込まれている WTV ファイルに存在するメディアタイプを列挙する初期プロファイルを取得します。
| ppProfile | ISBE2MediaTypeProfile** | out | プロファイルを実装する ISBE2MediaTypeProfile インターフェイスへのポインターを受け取ります。 |
戻り値
既定の入力プロファイルまたは現在の入力プロファイルを、このメソッドで指定したプロファイルに置き換えます。
| pProfile | ISBE2MediaTypeProfile* | in | クロスバーの既定プロファイルを置き換えるプロファイルの ISBE2MediaTypeProfile インターフェイスへのポインターです。 |
| pcOutputPins | DWORD* | out | 入力時には、新しいプロファイル内のストリームに対応する出力ピンの IPin ポインターを受け取るために割り当てられた配列のサイズを指定します。ppOutputPins パラメーターはこの配列を指します。出力時には、呼び出しが成功した場合、ppOutputPins 出力パラメーターで返される IPin ポインターの実際の数を取得します。 |
| ppOutputPins | IPin** | out | 入力時には、初期化されていない IPin ポインターの配列へのポインターを指定します。出力時には、呼び出しが成功した場合、配列内の IPin ポインターは、新しいプロファイルに列挙されたメディアタイプを持つフィルター出力ピンを指すように初期化されます。pcOutputPins パラメーターは配列内の要素数を示します。配列内で返される IPin インターフェイスポインターの解放は呼び出し側の責任です。 |
戻り値
HRESULT 値を返します。取り得る値には次のものがあります。
| 戻り値 | 説明 |
|---|---|
| 成功しました。 | |
| pProfile パラメーターが NULL です。 | |
| pcOutputPins パラメーターが NULL です。 | |
| プロファイル既定モードが有効になっているため、出力プロファイルを設定できません。 |
WTV ファイル内で検出されたすべてのストリームに対する列挙オブジェクトを取得します。ISBE2Crossbar インターフェイスを公開するフィルタークロスバーは、WTV ファイル内のストリームとフィルター出力ピンの間のマッピングを管理します。
| ppStreams | ISBE2EnumStream** | out | クロスバーが実装する ISBE2EnumStream インターフェイスへのポインターを受け取ります。 ISBE2EnumStream インターフェイスで定義されているメソッドを使用して、現在のプロファイルで出力ピンにマッピングできるストリームを列挙できます。インターフェイスの解放は呼び出し側の責任です。 |
戻り値
HRESULT 値を返します。取り得る値には次のものがあります。
| 戻り値 | 説明 |
|---|---|
| 成功しました。 | |
| NULL ポインター引数です。 | |
| ストリームが見つかりませんでした。 |
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_ISBE2Crossbar "{547B6D26-3226-487E-8253-8AA168749434}" #usecom global ISBE2Crossbar IID_ISBE2Crossbar "{}" #comfunc global ISBE2Crossbar_EnableDefaultMode 3 int #comfunc global ISBE2Crossbar_GetInitialProfile 4 sptr #comfunc global ISBE2Crossbar_SetOutputProfile 5 sptr,var,sptr #comfunc global ISBE2Crossbar_EnumStreams 6 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ISBE2Crossbar "{547B6D26-3226-487E-8253-8AA168749434}" #usecom global ISBE2Crossbar IID_ISBE2Crossbar "{}" #comfunc global ISBE2Crossbar_EnableDefaultMode 3 int #comfunc global ISBE2Crossbar_GetInitialProfile 4 sptr #comfunc global ISBE2Crossbar_SetOutputProfile 5 sptr,sptr,sptr #comfunc global ISBE2Crossbar_EnumStreams 6 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。