Firelight Technologies FMOD Studio API

Studio::EventInstance::setUserData

Sets arbitrary user data on the event instance.

C++ Syntax

FMOD_RESULT Studio::EventInstance::setUserData(
  void *userData
);

C Syntax

FMOD_RESULT FMOD_Studio_EventInstance_SetUserData(
  FMOD_STUDIO_EVENTINSTANCE *eventinstance,
  void *userData
);

Parameters

userData

Address of user data to be stored within the event instance object.

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

This function is primarily used in case the user wishes to 'attach' data to an FMOD object.
It can be useful if an FMOD callback passes an object of this type as a parameter, and the user does not know which object it is (if many of these types of objects exist). Using Studio::EventInstance::getUserData would help in the identification of the object.

See Also

• Studio::EventInstance::getUserData

Version 1.03.06 Built on Apr 17, 2014