MFCreateSourceReaderFromMediaSource 関数 (mfreadwrite.h)

  • [アーティクル]

メディア ソースからソース リーダーを作成します。

構文

HRESULT MFCreateSourceReaderFromMediaSource(
  [in]  IMFMediaSource  *pMediaSource,
  [in]  IMFAttributes   *pAttributes,
  [out] IMFSourceReader **ppSourceReader
);

パラメーター

[in] pMediaSource

メディア ソースの IMFMediaSource インターフェイスへのポインター。

[in] pAttributes

IMFAttributes インターフェイスへのポインター。 このパラメーターを使用して、ソース リーダーを構成できます。 詳細については、「 ソース リーダー属性」を参照してください。 このパラメーターは、NULL でもかまいません。

[out] ppSourceReader

IMFSourceReader インターフェイスへのポインターを受け取ります。 呼び出し元はインターフェイスを解放する必要があります。

戻り値

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

リターン コード 説明
S_OK
 メソッドが成功しました。
MF_E_DRM_UNSUPPORTED
 ソースには保護されたコンテンツが含まれています。

注釈

この関数を呼び出す前に 、CoInitialize(Ex) と MFStartup を 呼び出します。

既定では、アプリケーションがソース リーダーを解放すると、ソース リーダーはメディア ソースで IMFMediaSource::Shutdown を呼び出してメディア ソースをシャットダウンします。 その時点で、アプリケーションはメディア ソースを使用できなくなります。

この既定の動作を変更するには、pAttributes パラメーターで MF_SOURCE_READER_DISCONNECT_MEDIASOURCE_ON_SHUTDOWN 属性を設定します。 この属性が TRUE の場合、アプリケーションはメディア ソースのシャットダウンを担当します。

ソース リーダーを使用する場合は、メディア ソースで次のメソッドを呼び出さないでください。

この関数は、Windows Vista のプラットフォーム更新プログラムの補足がインストールされている場合に Windows Vista で使用できます。

要件

要件 値
サポートされている最小のクライアント Windows Vista 用 Windows 7、Windows Vista およびプラットフォーム更新プログラムの補足 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー mfreadwrite.h
Library Mfreadwrite.lib
[DLL] Mfreadwrite.dll

こちらもご覧ください

メディア ファンデーション機能

ソース リーダー