Implementation Capabilities#

Functions to report capabilities of available implementations and create user-requested library implementations.

API#

MFXQueryImplsDescription#

mfxHDL *MFXQueryImplsDescription(mfxImplCapsDeliveryFormat format, mfxU32 *num_impls)#

Delivers implementation capabilities in the requested format according to the format value.

Since

This function is available since API version 2.0.

Parameters:
  • format[in] Format in which capabilities must be delivered. See mfxImplCapsDeliveryFormat for more details.

  • num_impls[out] Number of the implementations.

Returns:

Array of handles to the capability report or NULL in case of unsupported format or NULL num_impls pointer. Length of array is equal to num_impls.

Important

The MFXQueryImplsDescription() function is mandatory for any implementation.

MFXQueryImplsProperties#

mfxHDL *MFXQueryImplsProperties(mfxQueryProperty **properties, mfxU32 num_properties, mfxU32 *num_impls)#

Delivers implementation capabilities for configured properties. The returned capability report will be sparsely filled out, with only properties available which were set via MFXSetConfigFilterProperty().

Since

This function is available since API version 2.15.

Parameters:
  • properties[in] Array of property name/value pairs indicating which properties to populate in the capability report.

  • num_properties[in] Number of property name/value pairs.

  • num_impls[out] Number of the implementations.

Returns:

Array of handles to the capability report or NULL in case of NULL properties pointer or zero num_properties or NULL num_impls pointer. Length of array is equal to num_impls.

MFXReleaseImplDescription#

mfxStatus MFXReleaseImplDescription(mfxHDL hdl)#

Destroys the handle allocated by the MFXQueryImplsDescription function or the MFXQueryImplsProperties function. Implementation must remember which handles are released. Once the last handle is released, this function must release memory allocated for the array of handles.

Since

This function is available since API version 2.0.

Parameters:

hdl[in] Handle to destroy. Can be equal to NULL.

Returns:

MFX_ERR_NONE The function completed successfully.

Important

The MFXReleaseImplDescription() function is mandatory for any implementation.