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

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

構文

HRESULT SetOutputPrefType(
  [in] DWORD        dwOutputIndex,
  [in] IMFMediaType *pType
);

[in] dwOutputIndex

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

[in] pType

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

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

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

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

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

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

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