Função MFTRegisterLocalByCLSID (mfapi.h)

Registra uma MFT (transformação do Media Foundation) no processo do chamador.

Sintaxe

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
);

Parâmetros

[in] clisdMFT

O CLSID (identificador de classe) do MFT.

[in] guidCategory

Um GUID que especifica a categoria do MFT. Para obter uma lista de categorias de MFT, consulte MFT_CATEGORY.

[in] pszName

Uma cadeia de caracteres largos terminada em nulo que contém o nome amigável do MFT.

[in] Flags

Um OR bit a bit de zero ou mais sinalizadores da enumeração _MFT_ENUM_FLAG .

[in] cInputTypes

O número de elementos na matriz pInputTypes .

[in] pInputTypes

Um ponteiro para uma matriz de estruturas de MFT_REGISTER_TYPE_INFO . Cada membro da matriz especifica um formato de entrada compatível com o MFT. Esse parâmetro poderá ser NULL se cInputTypes for zero.

[in] cOutputTypes

O número de elementos na matriz pOutputTypes .

[in] pOutputTypes

Um ponteiro para uma matriz de estruturas de MFT_REGISTER_TYPE_INFO . Cada membro da matriz define um formato de saída compatível com o MFT. Esse parâmetro poderá ser NULL se cOutputTypes for zero.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

A principal finalidade dessa função é disponibilizar um MFT para resolução de topologia automática sem disponibilizar o MFT para outros processos ou aplicativos.

Depois de chamar essa função, o MFT pode ser enumerado chamando a função MFTEnumEx com o sinalizador MFT_ENUM_FLAG_LOCALMFT . O MFT pode ser enumerado de dentro do mesmo processo, mas não é visível para outros processos.

Para cancelar o registro do MFT do processo atual, chame MFTUnregisterLocalByCLSID.

Se você precisar registrar um MFT no processo de PMP (Caminho de Mídia Protegida), use a interface IMFLocalMFTRegistration .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mfapi.h
Biblioteca	Mfplat.lib
DLL	Mfplat.dll

Confira também

MFTRegisterLocal

Funções do Media Foundation