Microsoft DirectX 8.1 (C++)

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 Value

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.

See Also