File Name Validation Flags

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

[Deprecated. This API may be removed from future releases of Windows.]

These flags specify the behavior of the media locator.

Constant/value	Description
SFN_VALIDATEF_CHECK 0x01	Check the validity of file names. You must set this flag to validate file names. If not, the other flags have no effect.
SFN_VALIDATEF_POPUP 0x02	If a file is not located, display an Open File dialog box for the end user.
SFN_VALIDATEF_TELLME 0x04	If a missing file is located, briefly display a message box with the name and location of the file. This flag is mostly useful for testing purposes; the message box is probably not suitable for a retail product.
SFN_VALIDATEF_REPLACE 0x08	If a missing file is located, update the name of the source object. (Only valid in the IAMTimeline::ValidateSourceNames method.)
SFN_VALIDATEF_USELOCAL 0x10	Always use a local file, even if a version of the file exists on the network.
SFN_VALIDATEF_NOFIND 0x20	Do not search for missing files. File names are still validated if you set the SFN_VALIDATEF_CHECK flag.
SFN_VALIDATEF_IGNOREMUTED 0x40	Ignore muted source objects. (Only valid in the IAMTimeline::ValidateSourceNames method.)

Requirements

Requirement	Value
Header	Qedit.h

See also

IMediaLocator::FindMediaFile

IRenderEngine::SetSourceNameValidation