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

関連項目

IMFMediaSink

メディア シンク