Utilisation du localisateur de média
[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.]
[Cette API n’est pas prise en charge et peut être modifiée ou indisponible à l’avenir.]
Le localisateur multimédia est un objet d’assistance qui vérifie les noms de fichiers et recherche les fichiers manquants dans les répertoires locaux ou réseau. Le détecteur de média conserve un cache des chemins d’accès de répertoires où il a trouvé des fichiers dans les recherches précédentes. Pour localiser un fichier, il recherche les répertoires dans son cache. À défaut, le détecteur multimédia peut afficher une boîte de dialogue Ouvrir un fichier pour permettre à l’utilisateur de localiser manuellement un fichier. En supposant que l’utilisateur localise le fichier, le localisateur multimédia ajoute le nouveau répertoire à son cache. Le localisateur multimédia expose l’interface IMediaLocator .
En règle générale, votre application ne crée pas directement d’instance du localisateur multimédia. Au lieu de cela, le chronologie et le moteur de rendu fournissent les méthodes suivantes pour valider les noms de fichiers à l’aide du détecteur multimédia.
- Pour valider les noms de fichiers dans le chronologie, appelez IAMTimeline::ValidateSourceNames. Éventuellement, cette méthode met également à jour les objets sources avec les noms de fichiers corrects.
- Pour valider les noms de fichiers lorsque le projet est rendu, appelez IRenderEngine::SetSourceNameValidation.
Les deux méthodes prennent des indicateurs qui contrôlent le comportement du localisateur de média. Par exemple, vous pouvez limiter la recherche aux répertoires locaux.
Rubriques connexes