Share via

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。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 Description
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
程式庫 Mfreadwrite.lib
Dll Mfreadwrite.dll

另請參閱

媒體基礎函式

來源讀取器