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

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

ビデオの罫線の色を設定します。 罫線の色は、ビデオのレターボックスに使用されます。

構文

HRESULT SetBorderColor(
  [in] COLORREF Clr
);

パラメーター

[in] Clr

罫線の色を COLORREF 値として指定します。 この値を作成するには、 RGB マクロを使用します。 既定値は黒です。

戻り値

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

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

注釈

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

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

要件

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

こちらもご覧ください

IMFPMediaPlayer

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