使用媒體定位器
[與此頁面相關聯的功能，DirectShow是舊版功能。 它已被 MediaPlayer、IMFMediaEngine和媒體基金會中的音訊/視訊擷取 取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft強烈建議新程式代碼盡可能在媒體 基礎中使用 MediaPlayer、IMFMediaEngine 和 音訊/視訊擷取，而不是 DirectShow。 Microsoft建議使用舊版 API 的現有程式代碼，盡可能改寫成使用新的 API。]
[此 API 不受支持，未來可能會改變或無法使用。]
媒體定位器是協助程序物件，可驗證檔名，並在本機或網路目錄中搜尋遺漏的檔案。 媒體偵測器會保留過去搜尋中成功找到檔案的目錄路徑快取。 若要尋找檔案，它會在其快取中搜尋目錄。 如果失敗，媒體偵測器可以顯示 [開啟檔案] 對話框，讓用戶手動尋找檔案。 假設使用者找到檔案，媒體定位器會將新目錄新增至其快取。 媒體定位器會公開 IMediaLocator 介面。
一般而言，您的應用程式不會直接建立媒體定位器的實例。 相反地，時間軸和轉譯引擎會提供下列方法來使用媒體偵測器驗證檔名。
- 若要在時間軸中驗證檔名，請呼叫 IAMTimeline：：ValidateSourceNames。 或者，這個方法也會使用正確的檔名來更新來源物件。
- 若要在轉譯項目時驗證檔名，請呼叫 IRenderEngine：：SetSourceNameValidation。
這兩種方法都會採用旗標來控制媒體定位器的行為。 例如，您可以將搜尋限制為本機目錄。
相關主題