Firelight Technologies FMOD Studio API

Sound::setUserData

Sets a user value that the Sound object will store internally. Can be retrieved with Sound::getUserData.

C++ Syntax

FMOD_RESULT Sound::setUserData(
  void *userdata
);

C Syntax

FMOD_RESULT FMOD_Sound_SetUserData(
  FMOD_SOUND *sound,
  void *userdata
);

C# Syntax

RESULT Sound.setUserData(
  IntPtr userdata
);

JavaScript Syntax

Sound.setUserData(
  userdata                         
);

Parameters

userdata

Address of user data that the user wishes stored within the Sound 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 Sound::getUserData would help in the identification of the object.

See Also

• Sound::getUserData

Version 1.10.03 Built on Feb 1, 2018