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

  • [アーティクル]

メディア シンクからストリーム シンクを削除します。

構文

HRESULT RemoveStreamSink(
  [in] DWORD dwStreamSinkIdentifier
);

パラメーター

[in] dwStreamSinkIdentifier

削除するストリームの識別子。 ストリーム識別子は、 IMFMediaSink::AddStreamSink を呼び出してストリーム シンクを追加するときに定義されます。

戻り値

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

リターン コード 説明
S_OK
 メソッドが成功しました。
E_INVALIDARG
 この特定のストリーム シンクは削除できません。
MF_E_INVALIDSTREAMNUMBER
 ストリーム番号が無効です。
MF_E_NOT_INITIALIZED
 メディア シンクが初期化されていません。
MF_E_SHUTDOWN
 メディア シンクの Shutdown メソッドが呼び出されました。
MF_E_STREAMSINKS_FIXED
 このメディア シンクには、ストリーム シンクの固定セットがあります。 Stream シンクは削除できません。

注釈

このメソッドが呼び出されると、対応するストリーム シンク オブジェクトは無効になります。 IMFMediaSink::GetStreamSinkByIndex メソッドと IMFMediaSink::GetStreamSinkById メソッドは、そのストリーム シンクを返さなくなります。 ( AddStreamSink を呼び出して) 別のストリームを追加する場合は、ストリーム識別子を再利用できます。

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

場合によっては、メディア シンクはこのメソッドをサポートしていますが、すべてのストリーム シンクを削除することはできません。 (たとえば、ストリーム 0 を削除できない場合があります)。

要件

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

こちらもご覧ください

IMFMediaSink

メディア シンク