IMFVideoMixerControl::SetStreamOutputRect メソッド (evr.h)
コンポジション四角形内のビデオ ストリームの位置を設定します。
構文
HRESULT SetStreamOutputRect(
[in] DWORD dwStreamID,
[in] const MFVideoNormalizedRect *pnrcOutput
);
パラメーター
[in] dwStreamID
ストリームの識別子。 EVR メディア シンクの場合、 IMFMediaSink::AddStreamSink メソッドが呼び出されたときにストリーム識別子が定義されます。 DirectShow EVR フィルターの場合、ストリーム識別子はピン インデックスに対応します。 参照ストリームは常にストリーム 0 です。
[in] pnrcOutput
ビデオ ストリームの外接する四角形を定義する MFVideoNormalizedRect 構造体へのポインター。
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
pnrcOutput で指定された外接する四角形の座標が無効です。 |
|
ストリーム識別子が無効です。 |
注釈
ミキサーは、最終的なビデオ イメージに対して相対的に指定された外接する四角形内に各ビデオ ストリームを描画します。 この外接する四角形は 、正規化された 座標で指定されます。 詳細については、 MFVideoNormalizedRect 構造体を参照してください。
外接する四角形の座標は、[0.0, 1.0] の範囲内である必要があります。 また、左上隅の X 座標と Y 座標は、右下隅の X 座標と Y 座標を超えることはできません。 言い換えると、境界の四角形はコンポジションの四角形内に完全に収まる必要があり、垂直方向または水平方向に反転することはできません。
次の図は、EVR がサブストリームを混在する方法を示しています。
ストリームの出力四角形は 、SetStreamOutputRect を呼び出すことによって指定されます。 ソース四角形は、 IMFVideoDisplayControl::SetVideoPosition を呼び出すことによって指定されます。 ミキサーは、ストリームを 1 つの境界四角形に混在させるときに、最初に出力四角形を適用します。 この外接する四角形は、 コンポジション空間と呼ばれます。 次に、発表者は、合成された画像にソース四角形を適用します。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | evr.h |
| Library | Strmiids.lib |