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

  • [アーティクル]

このノード上の出力ストリームの優先メディアの種類を取得します。

構文

HRESULT GetOutputPrefType(
  [in]  DWORD        dwOutputIndex,
  [out] IMFMediaType **ppType
);

パラメーター

[in] dwOutputIndex

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

[out] ppType

メディアの種類の IMFMediaType インターフェイスへのポインターを受け取ります。 呼び出し元はインターフェイスを解放する必要があります。

戻り値

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

リターン コード 説明
S_OK
 メソッドが成功しました。
E_FAIL
 このノードには、推奨される出力の種類がありません。
E_INVALIDARG
 ストリーム インデックスが無効です。
E_NOTIMPL
 このノードは出力ノードです。

解説

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

推奨される出力の種類は、トポロジ ローダーにヒントを提供します。 完全に解決されたトポロジでは、すべてのトポロジ ノードに推奨される出力の種類があるという保証はありません。 ノードの実際のメディアの種類を取得するには、ノードの基になるオブジェクトへのポインターを取得する必要があります。 (詳細については、「 MF_TOPOLOGY_TYPE 列挙」を参照してください)。

要件

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

関連項目

IMFTopologyNode

トポロジ