MFTRegisterLocalByCLSID 函式 (mfapi.h)

  • 發行項

在呼叫者的程式中註冊媒體基礎轉換 (MFT) 。

語法

HRESULT MFTRegisterLocalByCLSID(
  [in] REFCLSID                     clisdMFT,
  [in] REFGUID                      guidCategory,
  [in] LPCWSTR                      pszName,
  [in] UINT32                       Flags,
  [in] UINT32                       cInputTypes,
  [in] const MFT_REGISTER_TYPE_INFO *pInputTypes,
  [in] UINT32                       cOutputTypes,
  [in] const MFT_REGISTER_TYPE_INFO *pOutputTypes
);

參數

[in] clisdMFT

MFT) CLSID (類別標識碼。

[in] guidCategory

指定 MFT 類別目錄的 GUID。 如需 MFT 類別清單，請參閱 MFT_CATEGORY。

[in] pszName

寬字元 Null 終止字串，其中包含 MFT 的易記名稱。

[in] Flags

來自_MFT_ENUM_FLAG列舉之零個或多個旗標的位 OR。

[in] cInputTypes

pInputTypes 陣列中的元素數目。

[in] pInputTypes

MFT_REGISTER_TYPE_INFO 結構的陣列指標。 數位的每個成員都會指定 MFT 支援的輸入格式。 如果 cInputTypes 為零，此參數可以是 NULL。

[in] cOutputTypes

pOutputTypes 陣列中的項目數目。

[in] pOutputTypes

MFT_REGISTER_TYPE_INFO 結構的陣列指標。 陣列的每個成員都會定義 MFT 支援的輸出格式。 如果 cOutputTypes 為零，此參數可以是 NULL。

傳回值

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

備註

此函式的主要用途是讓 MFT 可用於自動拓撲解析，而不讓 MFT 可供其他進程或應用程式使用。

呼叫此函式之後，可以使用 MFT_ENUM_FLAG_LOCALMFT 旗標呼叫 MFTEnumEx 函式來列舉 MFT。 MFT 可以從同一個進程內列舉，但其他進程看不到。

若要從目前的進程取消註冊 MFT，請呼叫 MFTUnregisterLocalByCLSID。

如果您需要在受保護的媒體路徑中註冊 MFT (PMP) 程式，請使用 IMFLocalMFTRegistration 介面。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 mfapi.h
程式庫 Mfplat.lib
Dll Mfplat.dll

另請參閱

MFTRegisterLocal

媒體基礎函式