IMediaLocator 介面
[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。
注意
[已被取代。 此 API 可能會從未來的 Windows 版本中移除。]
介面 IMediaLocator 提供在 DirectShow Editing Services (DES) 中驗證檔案名的方法。 使用此介面可確保指定的檔案名和路徑對應至現有的檔案。 此介面也提供在其他位置搜尋檔案的方法，以及顯示 [ 開啟 ] 對話方塊，讓使用者可以找到該檔案。
媒體定位器會實作此介面。 時程表和轉譯引擎也支援透過下列方法進行檔案名驗證：
- IAMTimeline：：ValidateSourceNames：驗證及更新時程表中的檔案名。
- IRenderEngine：：SetSourceNameValidation：指定轉譯引擎在轉譯時驗證檔案名的方式。
一般而言，DES 應用程式會呼叫這些方法，而不是直接建立媒體定位器的實例。 如需詳細資訊，請參閱 使用媒體定位器。
成員
IMediaLocator介面繼承自IUnknown介面。 IMediaLocator 也有下列類型的成員：
方法
IMediaLocator介面具有這些方法。
| 方法 | Description |
|---|---|
| AddFoundLocation | 將目錄新增至目錄快取。 |
| FindMediaFile | 搜尋檔案，如果成功，則會擷取檔案的路徑。 |
備註
注意
標頭檔 Qedit.h 與 7 版之後的 Direct3D 標頭不相容。
注意
若要取得 Qedit.h，請下載Windows Vista Microsoft Windows SDK Update 和 .NET Framework 3.0。 Qedit.h 不適用於 Windows 7 和 .NET Framework 3.5 Service Pack 1 的 Microsoft Windows SDK。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|