IFileSinkFilter::SetFileName

Send Feedback

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

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 and AM_MEDIA_TYPE structure that describes 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

DirectShow applications and DirectShow filters have different include file and link library requirements.

For more information, see Setting Up the Build Environment.

Pocket PC: Windows Mobile 5.0 and later
Smartphone: Windows Mobile 5.0 and later
OS Versions: Windows CE 5.01 and later
Header:

See Also

IFileSinkFilter Interface | AM_MEDIA_TYPE

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.