filter

Call func for each media in this.

The result value of func determines what happens to the media. func will be called with this locked so no further actions on this can be performed from func.

If func returns REMOVE, the media will be removed from this.

If func returns KEEP, the media will remain in this.

If func returns REF, the media will remain in this but will also be added with an additional ref to the result List of this function..

When func is null, REF will be assumed for all media.

Parameters:

this	a Session
func	a callback
user_data	user data passed to func

Returns:

a GList with all media for which func returned REF. After usage, each element in the List should be unreffed before the list is freed.