IMFSinkWriter::SetInputMediaType メソッド (mfreadwrite.h)

シンクライターのストリームの入力形式を設定します。

構文

HRESULT SetInputMediaType(
  [in] DWORD         dwStreamIndex,
  [in] IMFMediaType  *pInputMediaType,
  [in] IMFAttributes *pEncodingParameters
);

[in] dwStreamIndex

ストリームの 0 から始まるインデックス。インデックスは、IMFSinkWriter::AddStream メソッドの pdwStreamIndex パラメーターによって受け取られます。

[in] pInputMediaType

メディア型の IMFMediaType インターフェイスへのポインター。メディアの種類は、入力形式を指定します。

[in] pEncodingParameters

属性ストアの IMFAttributes インターフェイスへのポインター。属性ストアを使用してエンコーダーを構成します。このパラメーターは、NULL でもかまいません。

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

リターンコード	説明
S_OK	メソッドが成功しました。
MF_E_INVALIDMEDIATYPE	基になるメディアシンクでは、形式がサポートされていない、変換できない、または動的な形式の変更が不可能です。
MF_E_INVALIDSTREAMNUMBER	dwStreamIndex パラメーターが無効です。
MF_E_TOPO_CODEC_NOT_FOUND	エンコードされた形式のエンコーダーが見つかりませんでした。

入力形式は、メディアシンクに書き込まれるターゲット形式と一致する必要はありません。形式が一致しない場合、メソッドは入力形式からターゲット形式にエンコードできるエンコーダーの読み込みを試みます。

ストリーミングが開始された後(つまり、 IMFSinkWriter::WriteSample を最初に呼び出した後)、いつでもこのメソッドを呼び出して入力形式を変更できます。ただし、基になるエンコーダーとメディアシンクでは、動的な形式の変更をサポートする必要があります。

このインターフェイスは、Windows Vista のプラットフォーム更新プログラムの補足がインストールされている場合に、Windows Vista で使用できます。

要件	値
サポートされている最小のクライアント	Windows Vista 用 Windows 7、Windows Vista およびプラットフォーム更新プログラムの補足 [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	mfreadwrite.h