IFileSourceFilter::Load method

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

Syntax


HRESULT Load(
  [in]       LPCOLESTR     pszFileName,
  [inconst 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 value

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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Strmif.h (include Dshow.h)

Library

Strmiids.lib

See also

Error and Success Codes
IFileSourceFilter Interface

 

 

Show: