MFRegisterLocalByteStreamHandler 函式 (mfapi.h)

在呼叫端的進程中註冊位元組數據流處理程式。

語法

HRESULT MFRegisterLocalByteStreamHandler(
  [in] PCWSTR      szFileExtension,
  [in] PCWSTR      szMimeType,
  [in] IMFActivate *pActivate
);

[in] szFileExtension

字串，包含這個處理程序的擴展名。

[in] szMimeType

包含此處理程式之MIME類型的字串。

[in] pActivate

啟用物件的 IMFActivate 介面指標。呼叫端會實作這個介面。啟用物件的 IMFActivate：：ActivateObject 方法必須建立位元組數據流處理程式。位元組數據流處理程式會公開 IMFByteStreamHandler 介面。

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

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

在進程內，本機位元組數據流處理程式的優先順序高於登錄中註冊的位元組數據流處理程式。其他進程看不到本機位元組數據流處理程式。

如果您想要為應用程式註冊自定義位元組數據流處理程式，但不想讓其他應用程式使用處理程式，請使用此函式。

szFileExtension 或 szMimeType 可以是 NULL;至少一個必須是非 NULL。