Method

GrlSourcemay_resolve

since: 0.2.0

Declaration [src]

gboolean
grl_source_may_resolve (
  GrlSource* source,
  GrlMedia* media,
  GrlKeyID key_id,
  GList** missing_keys
)

Description [src]

Checks whether key_id may be resolved with source for media, so that the caller can avoid calling grl_source_resolve() if it can be known in advance it will fail.

If the resolution is known to be impossible because more keys are needed in media, and missing_keys is not NULL, it is populated with the list of GrlKeyID that would be needed.

This function is synchronous and should not block.

Available since: 0.2.0

Parameters

media

Type: GrlMedia

A media on which we want more metadata.

The data is owned by the caller of the method.

key_id

Type: GrlKeyID

The key corresponding to a metadata we might want.

missing_keys

Type: A list of None

An optional originally empty list.

The data is owned by the caller of the method.

Return value

Type: gboolean

TRUE if there’s a possibility that source resolves key_id for media, FALSE otherwise.