IFileSinkFilter::SetFileName

  • Article
 
Microsoft DirectShow 9.0

IFileSinkFilter::SetFileName

The SetFileName method sets the name of the file into which media samples will be written.

Syntax

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

Parameters

pszFileName

[in] Pointer to the name of the file to receive the media samples.

pmt

[in] Pointer to the type of media samples to be written to the file, and the media type of the sink filter's input pin.

Return Values

Returns an HRESULT value.

Remarks

If the pszFileName parameter names a nonexistent file, the file will be created. If it names an existing file, the sink filter will overwrite the file without first deleting it.

Requirements

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

Library: Use Strmiids.lib.

See Also