MFRegisterLocalSchemeHandler 函式 (mfapi.h)

在呼叫端的進程中註冊配置處理程式。

語法

HRESULT MFRegisterLocalSchemeHandler(
  [in] PCWSTR      szScheme,
  [in] IMFActivate *pActivate
);

[in] szScheme

包含配置的字串。配置包含尾端『：』字元;例如，“HTTP：”。

[in] pActivate

啟用物件的 IMFActivate 介面指標。呼叫端會實作這個介面。啟用物件的 IMFActivate：：ActivateObject 方法必須建立配置處理程序物件。配置處理程式會公開 IMFSchemeHandler 介面。

如果此函式成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

配置處理程式會在來源解析程式期間用於 Microsoft Media Foundation，其會從 URL 建立媒體來源。如需詳細資訊，請參閱配置處理程式和 Byte-Stream 處理程式。

在進程中，本機配置處理程式的優先順序高於登錄中註冊的配置處理程式。其他進程看不到本機配置處理程式。

如果您想要為應用程式註冊自定義配置處理程式，但不想讓其他應用程式使用處理程式，請使用此函式。