IMFReadWriteClassFactory::CreateInstanceFromURL method (mfreadwrite.h)

Creates an instance of the sink writer or source reader, given a URL.

Syntax

HRESULT CreateInstanceFromURL(
  [in]  REFCLSID      clsid,
  [in]  LPCWSTR       pwszURL,
  [in]  IMFAttributes *pAttributes,
  [in]  REFIID        riid,
  [out] LPVOID        *ppvObject
);

Parameters

[in] clsid

The CLSID of the object to create.

Value Meaning
CLSID_MFSinkWriter
Create the sink writer. The ppvObject parameter receives an IMFSinkWriter interface pointer.
CLSID_MFSourceReader
Create the source reader. The ppvObject parameter receives an IMFSourceReader interface pointer.

[in] pwszURL

A null-terminated string that contains a URL. If clsid is CLSID_MFSinkWriter, the URL specifies the name of the output file. The sink writer creates a new file with this name. If clsid is CLSID_MFSourceReader, the URL specifies the input file for the source reader.

[in] pAttributes

A pointer to the IMFAttributes interface. You can use this parameter to configure the sink writer or source reader. For more information, see the following topics:

This parameter can be NULL.

[in] riid

The IID of the requested interface.

[out] ppvObject

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

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

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

Requirements

Requirement Value
Minimum supported client Windows 7, Windows Vista and Platform Update Supplement for Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header mfreadwrite.h

See also

IMFReadWriteClassFactory