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