ISpPhoneticAlphabetConverter::SAPI2UPS

Parameters

pszSAPIId

[in] The SAPI phone to be converted.

pszUPSId

[out] The UPS phone that was converted from SAPI.

cMaxLength

The length, in phonemes, of the caller-provided buffer pszUPSId, including the terminating null phoneme ID. Applications can supply a buffer size of SP_MAX_PRON_LENGTH + 1, or they can obtain the required size of the output buffer by calling GetMaxConvertLength.

Return values

Value

Description

SPERR_BUFFER_TOO_SMALL

The specified output buffer length is not sufficient.

SPERR_PHONEME_CONVERSION

The input phoneme string cannot be converted to the desired alphabet. This typically means the phoneme IDs are invalid for the current language.