Firelight Technologies FMOD Studio API

FMOD_CHANNELCONTROL_CALLBACK

Callback for channel events.

C/C++ Syntax

FMOD_RESULT F_CALLBACK FMOD_CHANNELCONTROL_CALLBACK(
  FMOD_CHANNEL *channel,
  FMOD_CHANNELCONTROL_CALLBACK_TYPE type,
  void *commanddata1,
  void *commanddata2
);

Parameters

channel

Pointer to a channel handle.

type

The type of callback. Refer to FMOD_CHANNELCONTROL_CALLBACK_TYPE.

commanddata1

The first callback type specific data generated by the callback. See remarks for meaning.

commanddata2

The second callback type specific data generated by the callback. See remarks for meaning.

Return Values

If the function succeeds then the return value is FMOD_OK.
If the function fails then the return value will be one of the values defined in the FMOD_RESULT enumeration.

Remarks

C++ Users. Cast FMOD_CHANNEL * to FMOD::Channel * inside the callback and use as normal.

'commanddata1' and 'commanddata2' meanings.
These 2 values are set by the callback depending on what is happening in the callback and the type of callback.

• FMOD_CHANNELCONTROL_CALLBACK_END
  commanddata1: Always 0.
  commanddata2: Always 0.
  
• FMOD_CHANNELCONTROL_CALLBACK_VIRTUALVOICE
  commanddata1: (cast to int) 0 when voice is swapped from emulated to real. 1 when voice is swapped from real to emulated.
  commanddata2: Always 0.
  
• FMOD_CHANNELCONTROL_CALLBACK_SYNCPOINT
  commanddata1: (cast to int) The index of the sync point. Use Sound::getSyncPointInfo to retrieve the sync point's attributes.
  commanddata2: Always 0.
  
• FMOD_CHANNELCONTROL_CALLBACK_OCCLUSION
  commanddata1: (cast to float *) pointer to a floating point direct value that can be read (dereferenced) and modified after the geometry engine has calculated it for this channel.
  commanddata2: (cast to float *) pointer to a floating point reverb value that can be read (dereferenced) and modified after the geometry engine has calculated it for this channel.
  

Note! Currently the user must call System::update for these callbacks to trigger!

See Also

• Channel::setCallback
• FMOD_CHANNELCONTROL_CALLBACK_TYPE
• System::update

Version 1.03.06 Built on Apr 17, 2014