Microsoft DirectX 9.0

MediaLocator.FindMediaFile Method

The FindMediaFile method searches for a file and, if successful, retrieves the path to the file.


    Input As String,
    FilterString As String,
    pOutput As String,
    Flags As Long



File name, including path, where the file was last known to reside. For source objects in the timeline, use the current media name.


String containing pairs of filter strings formatted as required by the lpstrFilter member of the Microsoft® Win32® OPENFILENAME structure. The media locator uses this filter if it displays an Open dialog box.


Variable that receives the actual path to the file, if it differs from the value contained in Input and if the method successfully locates the file.


Bitwise combination of zero or more of the following flags, from the File Name Validation Flags:

Error Codes

If the method fails, an error is raised, and Err.Number can be set to one of the following values:

Value Description
E_FAIL Failure.
E_INVALIDARG Argument is invalid.
E_POINTER NULL pointer argument.


If the SFN_VALIDATEF_POPUP flag is specified and the media locator cannot locate the file, this method displays an Open dialog box for the user to locate the file. If the user cancels the dialog box, the method raises an E_FAIL error. Your application should catch this error using an On Error statement:

If Err.Number = &H80004005 Then
    ' Did not locate the file.
End If

If the SFN_VALIDATEF_POPUP flag is not specified, and the media locator cannot locate the file, the method raises an E_FAIL error without displaying the dialog box.

The filter string for the Open dialog box, which is specified by the FilterString parameter, contains internal Null characters. For example, Video\0*.avi\0\0. You can use Chr(0) to specify the Null characters:

sNullStr = Chr(0)
sFilterStr = "Video" + sNullStr + "*.avi" + sNullStr + sNullStr

See Also