Export (0) Print
Expand All
Expand Minimize

MFCreateSourceReaderFromMediaSource function

Creates the source reader from a media source.

Syntax


HRESULT MFCreateSourceReaderFromMediaSource(
  _In_   IMFMediaSource *pMediaSource,
  _In_   IMFAttributes *pAttributes,
  _Out_  IMFSourceReader **ppSourceReader
);

Parameters

pMediaSource [in]

A pointer to the IMFMediaSource interface of a media source.

pAttributes [in]

Pointer to the IMFAttributes interface. You can use this parameter to configure the source reader. For more information, see Source Reader Attributes. This parameter can be NULL.

ppSourceReader [out]

Receives a pointer to the IMFSourceReader interface. The caller must release the interface.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return codeDescription
S_OK

The method succeeded.

MF_E_DRM_UNSUPPORTED

The source contains protected content.

 

Remarks

Call CoInitialize(Ex) and MFStartup before calling this function.

By default, when the application releases the source reader, the source reader shuts down the media source by calling IMFMediaSource::Shutdown on the media source. At that point, the application can no longer use the media source.

To change this default behavior, set the MF_SOURCE_READER_DISCONNECT_MEDIASOURCE_ON_SHUTDOWN attribute in the pAttributes parameter. If this attribute is TRUE, the application is responsible for shutting down the media source.

When using the Source Reader, do not call any of the following methods on the media source:

This function is available on Windows Vista if Platform Update Supplement for Windows Vista is installed.

Windows Phone 8.1: This API is supported.

Requirements

Minimum supported client

Windows 7, Windows Vista and Platform Update Supplement for Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 R2 [desktop apps | Windows Store apps]

Header

Mfreadwrite.h

Library

Mfreadwrite.lib

DLL

Mfreadwrite.dll

See also

Media Foundation Functions
Source Reader

 

 

Community Additions

ADD
Show:
© 2014 Microsoft