IMFPMediaPlayer::SetVideoSourceRect メソッド (mfplay.h)

  • [アーティクル]
大事な 廃止。 この API は、Windows の今後のリリースから削除される可能性があります。 アプリケーションでは、再生に メディア セッション を使用する必要があります。
 

ビデオ ソースの四角形を設定します。

MFPlay は、ビデオをこの四角形にクリップし、四角形を引き伸ばしてビデオ ウィンドウを塗りつぶします。

構文

HRESULT SetVideoSourceRect(
  [in] const MFVideoNormalizedRect *pnrcSource
);

パラメーター

[in] pnrcSource

ソース四角形を指定する MFVideoNormalizedRect 構造体へのポインター。 この四角形は、ビデオのどの部分を表示するかを定義します。 これは正規化された座標で指定され、次のように定義されます。

  • ビデオ画像の左上隅は (0, 0) です。
  • ビデオ画像の右下隅は (1、1) です。
イメージ全体を表示するには、ソースの四角形を {0, 0, 1, 1} に設定します。 これが既定値です。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
 メソッドが成功しました。
MF_E_INVALIDREQUEST
 現在のメディア項目にビデオが含まれていません。
MF_E_SHUTDOWN
 オブジェクトの Shutdown メソッドが呼び出されました。

注釈

MFPlay は、ソースの四角形を引き伸ばして、ビデオ ウィンドウ全体を塗りつぶします。 既定では、MFPlay はソースの正しい縦横比 (必要に応じてレターボックス化) を維持します。 レターボックスの色は、 IMFPMediaPlayer::SetBorderColor メソッドによって制御されます。

メディア項目が現在設定されていない場合、または現在のメディア項目にビデオが含まれていない場合、このメソッドは失敗します。

再生を開始する前にビデオの位置を設定するには、 MFP_EVENT_TYPE_MEDIAITEM_SET イベントのイベント ハンドラー内でこのメソッドを呼び出します。 詳細については、「 IMFPMediaPlayerCallback::OnMediaPlayerEvent」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mfplay.h

こちらもご覧ください

IMFPMediaPlayer

オーディオ/ビデオ再生に MFPlay を使用する