CLC_ErrorCode Input_AddModifierParameter	(	CPHOBJECT const	hInput,
		CPCHAR8 const *const	utf8Name,
		CPUINT16 const	wMsgNum,
		CPHOBJECT const	hIndexList,
		CPUINT16 const	wMidPointValue,
		CPCHAR8 const *const	utf8LabelMin,
		CPCHAR8 const *const	utf8LabelMidPoint,
		CPCHAR8 const *const	utf8LabelMax,
		DataTypes const	preferredDataType,
		CPUINT16 const	wGroup,
		ModifierInformationProfiles const	informationProfiles,
		ControllerTypes const	preferredControllerType,
		CPUINT32 const	dwParameterUserData,
		CPHOBJECT *const	phParameter
	)

Add a Modifier parameter.

Note

Don't forget to set the IOC_Explorable capability to the owner input in order to allow parameters exploration and remote control.

Parameters

[in]	hInput	Input handle
[in]	utf8Name	the parameter's name
[in]	wMsgNum	message number (see Modifiers)
[in]	hIndexList	handle of the related Index List, or CPHOBJECT_NULL if the parameter is not indexed.
[in]	wMidPointValue	the middle point value. Usually 0x8000
[in]	utf8LabelMin	the label for min position
[in]	utf8LabelMidPoint	the label for middle position
[in]	utf8LabelMax	the label for max position
[in]	preferredDataType	the preferred data type if any. Use DT_Knob16 by default.
[in]	wGroup	the parameter's group. Parameters having the same group number (>0) are physically attached.
[in]	informationProfiles	combination of optional information profiles. See ModifierProfiles
[in]	preferredControllerType	the preferred controller type for this parameter, without the CT_Msg* part. See ModifierInformationProfiles
[in]	dwParameterUserData	A 32 bit user data associated to the returned parameter handle. This data will be passed back to the application in parameter notifications.
[out]	phParameter	Pointer to the handle of the new parameter, or CPHOBJECT_NULL in case of error

Returns

Standard CHAILink Client return code. See CLC_ErrorCode enumeration.

Warning

This function can only be called in CopperLan context. This means in the pseudo task CPDoProcess(), in notification handlers or in asynchronous return handlers and not in SystemDoProcess() for instance.