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。

 

規格需求

需求	值
標頭	Qedit.h
程式庫	Strmiids.lib