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が返されます。

要件

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

関連項目

IMFTopologyNode

トポロジ