IFileSourceFilter::Load

  • Article
 
Microsoft DirectShow 9.0

IFileSourceFilter::Load

The Load method causes a source filter to load a media file.

Syntax

  HRESULT Load(
  LPCOLESTR pszFileName,
  const AM_MEDIA_TYPE *pmt
);

Parameters

pszFileName

[in] Pointer to the name of the file to open.

pmt

[in] Pointer to the media type of the file. This can be NULL.

Return Values

Returns an HRESULT value.

Remarks

This method initializates the interface. It is not designed to load multiple files, and any calls to this method after the first call will fail.

For the File Source (Async) filter, pszFileName specifies the absolute path name of a local file.  For the File Source (URL) filter, pszFileName specifies the URL of a file to download. For other filter implementations, pszFileName might require a file name or a URL, depending on the filter.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also