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

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mfidl.h
Library Mfuuid.lib

関連項目

IMFTopologyNode

トポロジ