ISpPhoneticAlphabetConverter::SAPI2UPS (Microsoft Speech Platform)

Microsoft Speech Platform SDK 11

Microsoft Speech Platform

ISpPhoneticAlphabetConverter::SAPI2UPS

Returns the UPS phone id of the specified SAPI phone.

HRESULT SAPI2UPS(
   SPPHONEID       *pszSAPIId
   SPPHONEID       *pszUPSId
   DWORD            cMaxLength
);

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.
S_OK Function completed successfully.