IMFPMediaItem::SetStreamSink メソッド (mfplay.h)

大事な 廃止。 この API は、今後の Windows リリースから削除される可能性があります。 アプリケーションでは、再生に メディア セッション を使用する必要があります。

 

メディア項目のメディア シンクを設定します。 メディア シンクは、1 つ以上のストリームからのデータを使用するオブジェクトです。

構文

HRESULT SetStreamSink(
  [in] DWORD    dwStreamIndex,
  [in] IUnknown *pMediaSink
);

パラメーター

[in] dwStreamIndex

メディア ソース上のストリームの 0 から始まるインデックス。 メディア シンクは、このストリームからデータを受信します。

[in] pMediaSink

メディア シンクを指定する IUnknown ポインター。 次のいずれかを渡します。

• ストリーム シンクへのポインター。 すべてのメディア シンクには、1 つ以上の ストリーム シンクが含まれています。 各ストリーム シンクは、1 つのストリームからデータを受信します。 ストリーム シンクは 、IMFStreamSink インターフェイスを公開する必要があります。
• メディア シンクを作成するアクティブ化オブジェクトへのポインター。 アクティブ化オブジェクトは 、IMFActivate インターフェイスを公開する必要があります。 メディア項目は、メディア シンクの最初のストリーム シンク (つまり、インデックス 0 のストリーム シンク) を使用します。
• NULL。 pMediaSink を NULL に設定すると、ストリームの種類の既定のメディア シンクが使用されます。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

既定では、MFPlay プレーヤー オブジェクトは ストリーミング オーディオ レンダラー (SAR) にオーディオ ストリームをレンダリングし、ビデオ ストリームを 拡張ビデオ レンダラー (EVR) にレンダリングします。 SetStreamSink メソッドを使用して、オーディオまたはビデオ ストリームに別のメディア シンクを提供できます。または、オーディオとビデオ以外のストリームの種類をサポートします。 また、SAR または EVR を使用する前に構成することもできます。

IMFPMediaPlayer::SetMediaItem を呼び出す前に、このメソッドを呼び出します。 SetMediaItem の後でこのメソッドを呼び出しても、再生を停止して SetMediaItem をもう一度呼び出さない限り、効果はありません。

既定のメディア シンクを使用するようにメディア項目をリセットするには、 pMediaSink を NULL に設定します。

リモート再生の最適化

アプリケーションがリモート デスクトップ経由で実行されていて、オーディオまたはビデオ ストリームに NULL 以外の値を指定してこのメソッドを呼び出す場合、MFPlay はリモート再生の最適化を無効にします。 この解説は、オーディオストリームとビデオストリームにのみ適用されます。 テキストなど、他のデータ型を含むストリームには適用されません。

要件

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

こちらもご覧ください

IMFPMediaItem

メディア シンク

オーディオ/ビデオ再生に MFPlay を使用する