LVSpeechPort::SetClientPropertyEx

Sets various properties for the entire client.

Function

• static int SetClientPropertyEx(int property,int valuetype,void* pvalue)

Parameters

property

Which property to modify. See Speech Port Properties for list of properties.

valuetype

The value type of the property being set. Legal values are:

PROP_EX_VALUE_TYPE_INT

PROP_EX_VALUE_TYPE_INT_PTR

PROP_EX_VALUE_TYPE_STRING

PROP_EX_VALUE_TYPE_FLOAT_PTR

Each property has a set of legal set of value types. See Speech Port Properties for value types available for each property.

pvalue

A pointer to the new value for the property specified. pvalue will be reinterpreted according to the valuetype provided.

Return Values

LV_SUCCESS

No errors. Property was set to specified value

LV_INVALID_HPORT

The port is not valid (either CreateClient has not been called or DestroyClient has been called prior to this call).

LV_INVALID_PROPERTY_VALUE

The value is invalid for the designated property (e.g. out of range).

LV_INVALID_PROPERTY_TARGET

The property cannot be set for the specified target.

LV_INVALID_PROPERTY_VALUE_TYPE

The property's type is incompatible with the declared type.

LV_INVALID_PROPERTY

The property does not exist.

LV_EXCEPTION

An exception occured while processing the request.

Remarks

This is a static function to set client properties without opening a port

In 10.2 and prior, due to a bug, setting PROP_EX_BUILTIN_GRAMMAR_LANGUAGE to PROP_EX_TARGET_CLIENT returns 0 if pvalue is NULL and 1 for success. This has been fixed for the next release.

The targets PROP_EX_TARGET_CHANNEL and PROP_EX_TARGET_GRAMMAR are deprecated

See Also

• Speech Port Properties
• LVSpeechPort::SetPropertyEx
• LVSpeechPort::GetIntPropertyEx
• LVSpeechPort::GetFloatPropertyEx
• LVSpeechPort::GetStringPropertyEx
• LVSpeechPort::GetClientIntPropertyEx
• LVSpeechPort::GetClientFloatPropertyEx
• LVSpeechPort::GetClientStringPropertyEx
• LVSpeechPort::SetClientPropertyExPermanent
• LV_SRE_SetPropertyEx (C API)