Interface IMediaLocator
[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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.]
Notes
[Déconseillé. Cette API peut être supprimée des versions ultérieures de Windows.]
L’interface IMediaLocator fournit des méthodes pour valider les noms de fichiers dans DirectShow Editing Services (DES). Utilisez cette interface pour vous assurer qu’un nom de fichier et un chemin d’accès donnés correspondent à un fichier existant. Cette interface permet également de rechercher le fichier à d’autres emplacements et d’afficher une boîte de dialogue Ouvrir afin que l’utilisateur puisse localiser le fichier.
Le localisateur de média implémente cette interface. Le chronologie et le moteur de rendu prennent également en charge la validation de nom de fichier via les méthodes suivantes :
- IAMTimeline::ValidateSourceNames : valide et met à jour les noms de fichiers dans le chronologie.
- IRenderEngine::SetSourceNameValidation : spécifie comment le moteur de rendu valide les noms de fichiers au moment du rendu.
En règle générale, une application DES appelle ces méthodes plutôt que de créer directement une instance du localisateur de média. Pour plus d’informations, consultez Utilisation du localisateur de média.
Membres
L’interface IMediaLocator hérite de l’interface IUnknown . IMediaLocator a également les types de membres suivants :
Méthodes
L’interface IMediaLocator a ces méthodes.
| Méthode | Description |
|---|---|
| AddFoundLocation | Ajoute un répertoire au cache de répertoires. |
| FindMediaFile | Recherche un fichier et, en cas de réussite, récupère le chemin d’accès au fichier. |
Notes
Notes
Le fichier d’en-tête Qedit.h n’est pas compatible avec les en-têtes Direct3D ultérieurs à la version 7.
Notes
Pour obtenir Qedit.h, téléchargez Microsoft Windows SDK Update pour Windows Vista et .NET Framework 3.0. Qedit.h n’est pas disponible dans le Microsoft Windows SDK pour Windows 7 et .NET Framework 3.5 Service Pack 1.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|