使用媒體定位器

[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

[此 API 不受支援，未來可能會變更或無法使用。]

媒體定位器是協助程式物件，可驗證檔案名，並在本機或網路目錄中搜尋遺漏的檔案。 媒體偵測器會保留目錄路徑的快取，其在過去搜尋中已成功找到檔案。 若要尋找檔案，它會在其快取中搜尋目錄。 失敗，媒體偵測器可以顯示 [開啟檔案] 對話方塊，讓使用者手動尋找檔案。 假設使用者找到檔案，媒體定位器會將新目錄新增至其快取。 媒體定位器會公開 IMediaLocator 介面。

一般而言，您的應用程式不會直接建立媒體定位器的實例。 相反地，時間軸和轉譯引擎會提供下列方法來使用媒體偵測器來驗證檔案名。

• 若要驗證時程表中的檔案名，請呼叫 IAMTimeline：：ValidateSourceNames。 或者，這個方法也會使用正確的檔案名來更新來源物件。
• 若要在轉譯專案時驗證檔案名，請呼叫 IRenderEngine：：SetSourceNameValidation。

這兩種方法都會採用可控制媒體定位器行為的旗標。 例如，您可以將搜尋限制為本機目錄。

相關主題

使用來源