| Microsoft DirectX 8.1 (C++) |
The ValidateSourceNames method validates source names in the timeline, using the media locator. Optionally, this method also updates any source object for which it locates a file.
Syntax
HRESULT ValidateSourceNames(
long ValidateFlags,
IMediaLocator *pOverride,
long NotifyEventHandle
);
Parameters
ValidateFlags
Bitwise combination of File Name Validation Flags specifying the behavior of the media locator. The SFN_VALIDATEF_REPLACE and SFN_VALIDATEF_CHECK flags must be present, or the method returns E_INVALIDARG.
pOverride
Optional pointer to the IMediaLocator interface of a media locator to use in place of the default. To use the default media locator, set the value of this parameter to NULL. See Remarks for more information.
NotifyEventHandle
Handle to an event. The method signals the event after it has completed the validation.
Return Value
Returns S_OK if successful. Otherwise, returns E_INVALIDARG or another error code.
Remarks
Using the pOverride parameter, you can supply your own custom implementation of the IMediaLocator interface. For example, the default media locator will not notify your application about the files that it finds (or cannot find). To get around this limitation, you could implement a custom media locator, making it a wrapper for the default version. In your custom version, pass IMediaLocator::FindMediaFile calls directly to the default version, and examine the return value.
See Also