Attributes

HFCE parameters such as bus speed can be read or modified using the mxfAttributeUint64Get(), mxfAttributeDoubleGet(), mxfAttributeUint64Set() and mxfAttributeDoubleSet() functions by passing the handle (device, module or channel) and attribute key-value pair.

See the section Attributes Reference for a description of all supported attributes.

Some other utilities functions are used to get information about attributes:

• mxfAttributeInfoGet()

  Returns the name, type and property of an attribute.

• mxfAttributeInfoDetailsGet()

  Gets the scope of an attribute: min/max values, resolution.

• mxfAttributeListGet()

  Returns the attribute list of the specified handle (device, module or channel).

• mxfAttributeCountGet()

  Returns the number of attributes related to a specific handle (device, module or channel).

The example code below shows how to configure an HFCE channel speed by changing the speed.

{
MXF_ATTRIBUTE_INFO_UINT64_DETAILS info;      // Attribute detail structure
HMXF_CHANNEL tx;                             // Channel handle
uint32 rc;

   ...

   //Obtains the max frequency value 
   if(!rc)
      rc = mxfAttributeInfoDetailsGet(tx, KMXF_HFCE_SPEED, &info);

   //Sets the clock frequency with the max frequency value 
   if(!rc)
      rc = mxfAttributeUint64Set(tx, KMXF_HFCE_SPEED, info.details.range.max);

   ...
}