IAMTimeline::ValidateSourceNames, méthode

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La ValidateSourceNames méthode valide les noms de sources dans le chronologie, à l’aide du localisateur multimédia. Éventuellement, cette méthode met également à jour tout objet source pour lequel elle localise un fichier.

Syntaxe

HRESULT ValidateSourceNames(
   long          ValidateFlags,
   IMediaLocator *pOverride,
   long          NotifyEventHandle
);

Paramètres

ValidateFlags

Combinaison au niveau du bit d’indicateurs de validation de nom de fichier spécifiant le comportement du localisateur multimédia. Les indicateurs SFN_VALIDATEF_REPLACE et SFN_VALIDATEF_CHECK doivent être présents, ou la méthode retourne E_INVALIDARG.

pOverride

Pointeur facultatif vers l’interface IMediaLocator d’un localisateur multimédia à utiliser à la place de la valeur par défaut. Pour utiliser le localisateur multimédia par défaut, définissez la valeur de ce paramètre sur NULL. Pour plus d'informations, consultez la section Notes.

NotifyEventHandle

Handle vers un événement. La méthode signale l’événement une fois la validation terminée.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

À l’aide du paramètre pOverride , vous pouvez fournir votre propre implémentation personnalisée de l’interface IMediaLocator . Par exemple, le localisateur multimédia par défaut n’informe pas votre application des fichiers qu’elle trouve (ou qu’elle ne trouve pas). Pour contourner cette limitation, vous pouvez implémenter un localisateur de média personnalisé, ce qui en fait un wrapper pour la version par défaut. Dans votre version personnalisée, transmettez les appels IMediaLocator::FindMediaFile directement à la version par défaut et examinez la valeur de retour.

Configuration requise

Voir aussi

IAMTimeline Interface

Codes d’erreur et de réussite