This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

`AODeConstructor`

Functions to create or destroy a filter

Synopsis:

static AODeConstructor media_filter =
{
        Create,
        Destroy
};

Description:

This interface defines the functions required to create and destroy a handle (MmFilter_t in the case of multimedia filters) for use with other interfaces in the filter.

Create()

void *(*Create)(const AOICtrl_t *interfaces);

This function should create and return a handle for the filter. It should initialize the filter, including setting up most of the filter's variables, as well as its channels and their variables. This typically involves allocating and initializing a MmFilterUser_t structure, and assigning it to the user member of the MmFilter_t filter handle.

The interfaces parameter is typically not required. It's included in case you need access to other interfaces in your filter.

Destroy()

int32_t (*Destroy)(void *handle);

This function should destroy the filter handle, freeing any memory allocated for it.

If successful, this function should return 0.

Classification:

Neutrino