IMFMediaSink::AddStreamSink メソッド (mfidl.h)

メディアシンクに新しいストリームシンクを追加します。

構文

HRESULT AddStreamSink(
  [in]  DWORD         dwStreamSinkIdentifier,
  [in]  IMFMediaType  *pMediaType,
  [out] IMFStreamSink **ppStreamSink
);

[in] dwStreamSinkIdentifier

新しいストリームの識別子。値は任意ですが、一意である必要があります。

[in] pMediaType

ストリームのメディアの種類を指定する IMFMediaType インターフェイスへのポインター。このパラメーターは、NULL でもかまいません。

[out] ppStreamSink

新しいストリームシンクの IMFStreamSink インターフェイスへのポインターを受け取ります。呼び出し元はインターフェイスを解放する必要があります。

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

リターンコード	説明
S_OK	メソッドが成功しました。
MF_E_INVALIDSTREAMNUMBER	指定されたストリーム識別子が無効です。
MF_E_SHUTDOWN	メディアシンクの Shutdown メソッドが呼び出されました。
MF_E_STREAMSINK_EXISTS	同じストリーム識別子を持つストリームシンクが既に存在します。
MF_E_STREAMSINKS_FIXED	このメディアシンクには、ストリームシンクの固定セットがあります。新しいストリームシンクを追加できません。

すべてのメディアシンクがこのメソッドをサポートしているわけではありません。メディアシンクがこのメソッドをサポートしていない場合、 IMFMediaSink::GetCharacteristics メソッドは MEDIASINK_FIXED_STREAMS フラグを返します。

pMediaType が NULL の場合は、IMFMediaTypeHandler インターフェイスを使用してメディアの種類を設定します。 IMFStreamSink::GetMediaTypeHandler を呼び出して、インターフェイスへのポインターを取得します。


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