MFGetMFTMerit function (mfapi.h)

Gets the merit value of a hardware codec.

Syntax

HRESULT MFGetMFTMerit(
  [in, out] IUnknown   *pMFT,
  [in]      UINT32     cbVerifier,
  [in]      const BYTE *verifier,
  [out]     DWORD      *merit
);

Parameters

[in, out] pMFT

A pointer to the IUnknown interface of the Media Foundation transform (MFT) that represents the codec.

[in] cbVerifier

The size, in bytes, of the verifier array.

[in] verifier

The address of a buffer that contains one of the following:

• The class identifier (CLSID) of the MFT.
• A null-terminated wide-character string that contains the symbol link for the underlying hardware device. Include the size of the terminating null in the value of cbVerifier.

[out] merit

Receives the merit value.

Return value

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

Remarks

The function fails if the MFT does not represent a hardware device with a valid Output Protection Manager (OPM) certificate.

Requirements

See also

Media Foundation Functions

OPM_GET_CODEC_INFO