Free Online Library Of Help Files. Read help files in convenient way.

Leading Translation Management System for Translation Agencies, Top Translation Management Software for Freelance Translators, Time Tracking Software, Word Count, Character Count and Line Count Software, Computer Assisted Translation Tool for Easy Word Count, Clipboard Character Count Software, User-Friendly Translation Memory Software, Terminology Management Software, Terminology Management Server, Microsoft Glossary Software, Dictionary of Acronyms, Social Network for Translators and Translation Agencies, Acronyms and Abbreviations Search Engine, Russian Translation Lab, Ukrainian Translation Lab.

You are reading help file online using chmlib.com

ISpSRAlternates::GetAlternates

GetAlternates retrieves a list of alternate phrases.

SAPI calls GetAlternates when an application calls ISpRecoResult::GetAlternates. The alternate analyzer uses the SPPHRASEALTREQUEST information to generate at most, the requested number of alternate phrases, returned using the SPPHRASEALT pointer.

If the alternate analyze needs information that is not included in the phrase structure (see SPPHRASE), the speech recognition (SR) engine can store a custom, private block of data that is sent to the alternate analyze in the SPPHRASEALTREQUEST.pvResultExtra field. See also SPPARSEINFO.pSREnginePrivateData and SPPHRASE.pSREnginePrivateData.

The alternate analyzer communicates with the SR engine by retrieving the ISpRecoContext interface from the SPPHRASEALTREQUEST.pRecoContext field, and querying (see IUnknown::QueryInterface) for the SR engine's private extension (see ISpPrivateEngineCall).

HRESULT GetAlternates(
   SPPHRASEALTREQUEST   *pAltRequest,
   SPPHRASEALT         **ppAlts,
   ULONG                *pcAlts
);

Parameters

pAltRequest

[in] Pointer to a structure of type, SPPHRASEALTREQUEST, which points to information about the alternate request (e.g., original phrase, number of alternates requested, private SR engine data, etc.).

ppAlts

[out] Pointer to a list of structures of type SPPHRASEALT for alternate phrases. The alternate analyzer uses the ISpPhraseBuilder interface to create the alternate phrases and return pointers to the alternates in the SPPHRASEALT.pPhrase field.

pcAlts

[out] The actual number of alternates in ppAltslist. The alternate analyzer returns the number of alternates it actually generated. If it cannot generate alternates for the original phrase, it should return zero. The number should be less than or equal to the number requested by the application (see SPPHRASEALTREQUEST.ulRequestAltCount).

Return values