Verwenden des Medienlocators
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
[Diese API wird nicht unterstützt und kann in Zukunft geändert oder nicht mehr verfügbar sein.]
Der Medienlocator ist ein Hilfsobjekt, das Dateinamen überprüft und nach fehlenden Dateien in lokalen oder Netzwerkverzeichnissen sucht. Der Mediendetektor speichert einen Cache mit Verzeichnispfaden, in denen dateien in früheren Suchvorgängen erfolgreich gefunden wurden. Um nach einer Datei zu suchen, durchsucht sie die Verzeichnisse im Cache. Andernfalls kann der Mediendetektor ein Dialogfeld Datei öffnen anzeigen, damit der Benutzer eine Datei manuell suchen kann. Wenn der Benutzer die Datei sucht, fügt der Medienlocator dem Cache das neue Verzeichnis hinzu. Der Medienlocator macht die IMediaLocator-Schnittstelle verfügbar.
In der Regel erstellt Ihre Anwendung keine direkte instance des Medienlocators. Stattdessen stellen die Zeitleiste und die Render-Engine die folgenden Methoden zum Überprüfen von Dateinamen mithilfe des Mediendetektors bereit.
- Um Dateinamen in der Zeitleiste zu überprüfen, rufen Sie IAMTimeline::ValidateSourceNames auf. Optional aktualisiert diese Methode auch die Quellobjekte mit den richtigen Dateinamen.
- Um dateinamen zu überprüfen, wenn das Projekt gerendert wird, rufen Sie IRenderEngine::SetSourceNameValidation auf.
Beide Methoden verwenden Flags, die das Verhalten des Medienlocators steuern. Beispielsweise können Sie die Suche auf lokale Verzeichnisse beschränken.
Zugehörige Themen