Função MFTGetInfo (mfapi.h)

  • Artigo

Obtém informações do registro sobre uma MFT (transformação do Media Foundation).

Sintaxe

HRESULT MFTGetInfo(
  [in]  CLSID                  clsidMFT,
  [out] LPWSTR                 *pszName,
  [out] MFT_REGISTER_TYPE_INFO **ppInputTypes,
  [out] UINT32                 *pcInputTypes,
  [out] MFT_REGISTER_TYPE_INFO **ppOutputTypes,
  [out] UINT32                 *pcOutputTypes,
  [out] IMFAttributes          **ppAttributes
);

Parâmetros

[in] clsidMFT

O CLSID do MFT.

[out] pszName

Recebe um ponteiro para uma cadeia de caracteres largos que contém o nome amigável do MFT. O chamador deve liberar a cadeia de caracteres chamando CoTaskMemFree. Este parâmetro pode ser NULL.

[out] ppInputTypes

Recebe um ponteiro para uma matriz de estruturas de MFT_REGISTER_TYPE_INFO . Cada membro da matriz descreve um formato de entrada compatível com o MFT. O chamador deve liberar a matriz chamando CoTaskMemFree. Este parâmetro pode ser NULL.

[out] pcInputTypes

Recebe o número de elementos na matriz ppInputTypes . Se ppInputTypes for NULL, esse parâmetro será ignorado e poderá ser NULL.

[out] ppOutputTypes

Recebe um ponteiro para uma matriz de estruturas de MFT_REGISTER_TYPE_INFO . Cada membro da matriz descreve um formato de saída compatível com o MFT. O chamador deve liberar a matriz chamando CoTaskMemFree. Este parâmetro pode ser NULL.

[out] pcOutputTypes

Recebe o número de elementos na matriz ppOutputType . Se ppOutputTypes for NULL, esse parâmetro será ignorado e poderá ser NULL.

[out] ppAttributes

Recebe um ponteiro para a interface IMFAttributes de um repositório de atributos. O chamador deve liberar a interface. O repositório de atributos pode conter atributos armazenados no registro do MFT especificado. (Para obter mais informações, consulte MFTRegister.) Se nenhum atributo for armazenado no registro para esse MFT, o repositório de atributos estará vazio.

Este parâmetro pode ser NULL.

Valor retornado

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

Requisitos

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

Confira também

MFTEnum

MFTRegister

Funções do Media Foundation

Transformações do Media Foundation

Registrar e enumerar MFTs