IMFSourceResolver::CreateObjectFromByteStream method (mfidl.h)

Article
10/13/2021

Creates a media source from a byte stream. This method is synchronous.

Syntax

HRESULT CreateObjectFromByteStream(
  [in]  IMFByteStream  *pByteStream,
  [in]  LPCWSTR        pwszURL,
  [in]  DWORD          dwFlags,
  [in]  IPropertyStore *pProps,
  [out] MF_OBJECT_TYPE *pObjectType,
  [out] IUnknown       **ppObject
);

Parameters

[in] pByteStream

Pointer to the byte stream's IMFByteStream interface.

[in] pwszURL

Null-terminated string that contains the URL of the byte stream. The URL is optional and can be NULL. See Remarks for more information.

[in] dwFlags

Bitwise OR of flags. See Source Resolver Flags.

[in] pProps

Pointer to the IPropertyStore interface of a property store. The method passes the property store to the byte-stream handler. The byte-stream handler can use the property store to configure the media source. This parameter can be NULL. For more information, see Configuring a Media Source.

[out] pObjectType

Receives a member of the MF_OBJECT_TYPE enumeration, specifying the type of object that was created.

[out] ppObject

Receives a pointer to the media source's IUnknown 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 code	Description
S_OK	The method succeeded.
MF_E_SOURCERESOLVER_MUTUALLY_EXCLUSIVE_FLAGS	The dwFlags parameter contains mutually exclusive flags.
MF_E_UNSUPPORTED_BYTESTREAM_TYPE	This byte stream is not supported.

Remarks

The dwFlags parameter must contain the MF_RESOLUTION_MEDIASOURCE flag and should not contain the MF_RESOLUTION_BYTESTREAM flag.

The source resolver attempts to find one or more byte-stream handlers for the byte stream, based on the file name extension of the URL, or the MIME type of the byte stream (or both). The URL is specified in the optional pwszURL parameter, and the MIME type may be specified in the MF_BYTESTREAM_CONTENT_TYPE attribute on the byte stream. Byte-stream handlers are registered by file name extension or MIME type, or both, as described in Scheme Handlers and Byte-Stream Handlers. The caller should specify at least one of these values (both if possible):

Specify the URL in the pwszURL parameter.
Specify the MIME type by setting the MF_BYTESTREAM_CONTENT_TYPE attribute on the byte stream. (This attribute might be set already when you create the byte stream, depending on how the byte stream was created.)

Note This method cannot be called remotely.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2008 [desktop apps \| UWP apps]
Target Platform	Windows
Header	mfidl.h
Library	Mfuuid.lib

Share via