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

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

ビデオソースの四角形を取得します。

構文

HRESULT GetVideoSourceRect(
  [out] MFVideoNormalizedRect *pnrcSource
);

[out] pnrcSource

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

ソースの四角形が {0、0、1、1} の場合は、画像全体が表示されます。これが既定値です。

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

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

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