メディア ロケーターの使用
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
[この API はサポートされていないため、今後変更または使用できない可能性があります。]
メディア ロケーターは、ファイル名を検証し、ローカル ディレクトリまたはネットワーク ディレクトリ上の不足しているファイルを検索するヘルパー オブジェクトです。 メディア検出機能は、過去の検索でファイルが正常に検出されたディレクトリ パスのキャッシュを保持します。 ファイルを見つけるには、キャッシュ内のディレクトリを検索します。 失敗すると、メディア検出器は、ユーザーがファイルを手動で検索するための [ファイルを開く] ダイアログを表示できます。 ユーザーがファイルを見つけたと仮定すると、メディア ロケーターは新しいディレクトリをキャッシュに追加します。 メディア ロケーターは 、IMediaLocator インターフェイスを 公開します。
通常、アプリケーションはメディア ロケーターのインスタンスを直接作成しません。 代わりに、タイムラインとレンダリング エンジンは、メディア検出機能を使用してファイル名を検証するための次のメソッドを提供します。
- タイムラインでファイル名を検証するには、IAMTimeline::ValidateSourceNames を呼び出します。 必要に応じて、このメソッドはソース オブジェクトを正しいファイル名で更新します。
- プロジェクトのレンダリング時にファイル名を検証するには、 IRenderEngine::SetSourceNameValidation を呼び出します。
どちらのメソッドも、メディア ロケーターの動作を制御するフラグを受け取ります。 たとえば、検索をローカル ディレクトリに制限できます。
関連トピック