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

MmGetResourceValue()

Get the value of a resource for a graph or filter

Synopsis:

const void *MmGetResourceValue(const void *element,
                               const char *resource);

Arguments:

element

A pointer to the graph or filter you want to get the resource for.

resource

The name of the resource you want to get the value of.

Library:

mmedia

Description:

This function gets the resource value data for the resource. The returned value is read-only. You must cast the return value to the proper type.

You can get more complete information for a resource (including type, range, etc.) by using MmGetResource(). Use MmSetResourceValue() to change the value of a resource.

These defined convenience macros make getting specific value types easier:

• MmGetResourceINT64(element, resource, destination) - destination is returned as an int_64.
• MmGetResourceINT32(element, resource, destination) - destination is returned as an int_32.
• MmGetResourceSTRING(element, resource, destination>) - destination is returned as a char *.

Returns:

A pointer to the resource value if successful, NULL otherwise.

Classification:

Neutrino

See also:

MmSetResourceValue()