IMFTopologyNode::SetInputPrefType メソッド (mfidl.h)

このノードの入力ストリームに推奨されるメディアの種類を設定します。

構文

HRESULT SetInputPrefType(
  [in] DWORD        dwInputIndex,
  [in] IMFMediaType *pType
);

[in] dwInputIndex

入力ストリームの 0 から始まるインデックス。

[in] pType

メディアの種類の IMFMediaType インターフェイスへのポインター。

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

リターンコード	説明
S_OK	メソッドが成功しました。
E_NOTIMPL	このノードはソースノードです。

推奨される型は、トポロジローダーのヒントです。

トポロジの読み込み後、またはメディアセッションでトポロジを設定した後は、このメソッドを呼び出さないでください。実行中のトポロジで優先する種類を変更すると、接続エラーが発生する可能性があります。

指定したインデックスに入力ストリームが存在しない場合、メソッドは、指定したインデックス番号までの新しいストリームを作成します。

ソースノードに入力を含めることはできません。このメソッドがソースノードで呼び出されると、E_NOTIMPLが返されます。