MFTGetInfo function (mfapi.h)

Gets information from the registry about a Media Foundation transform (MFT).

Syntax

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

Parameters

[in] clsidMFT

The CLSID of the MFT.

[out] pszName

Receives a pointer to a wide-character string containing the friendly name of the MFT. The caller must free the string by calling CoTaskMemFree. This parameter can be NULL.

[out] ppInputTypes

Receives a pointer to an array of MFT_REGISTER_TYPE_INFO structures. Each member of the array describes an input format that the MFT supports. The caller must free the array by calling CoTaskMemFree. This parameter can be NULL.

[out] pcInputTypes

Receives the number of elements in the ppInputTypes array. If ppInputTypes is NULL, this parameter is ignored and can be NULL.

[out] ppOutputTypes

Receives a pointer to an array of MFT_REGISTER_TYPE_INFO structures. Each member of the array describes an output format that the MFT supports. The caller must free the array by calling CoTaskMemFree. This parameter can be NULL.

[out] pcOutputTypes

Receives the number of elements in the ppOutputType array. If ppOutputTypes is NULL, this parameter is ignored and can be NULL.

[out] ppAttributes

Receives a pointer to the IMFAttributes interface of an attribute store. The caller must release the interface. The attribute store might contain attributes that are stored in the registry for the specified MFT. (For more information, see MFTRegister.) If no attributes are stored in the registry for this MFT, the attribute store is empty.

This parameter can be NULL.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header mfapi.h
Library Mfplat.lib
DLL Mfplat.dll

See also

MFTEnum

MFTRegister

Media Foundation Functions

Media Foundation Transforms

Registering and Enumerating MFTs