HRESULT PhraseFinish(DWORD dwFlags, PSRPHRASE pSRPhrase);
Informs the application that the speaker has finished a phrase and the speech-recognition engine is certain about the words that were spoken.
· Return value is ignored.
dwFlags
[in] This parameter can be one or both of the following values:
Value | Meaning |
ISRNOTEFIN_RECOGNIZED | The recognition was above the threshold set with the ISRAttributes::ThresholdSet member function. If this flag is not set, the engine did not have enough confidence in the recognition, and it should be declared as an "unknown utterance." |
ISRNOTEFIN_THISGRAMMAR | This grammar had the highest score of all active grammars and claimed the recognition. If this flag is not set, another grammar had a higher score and claimed the recognition. |
For an application to accept a recognition as valid, both ISRNOTEFIN_RECOGNIZED and ISRNOTEFIN_THISGRAMMAR should be set.
pSRPhrase
[in] Address of an SRPHRASE structure that contains the engine's best recognition choice for the phrase. If dwFlags does not contain either ISRNOTEFIN_RECOGNIZED or ISRNOTEFIN_THISGRAMMAR, pSRPhrase may be NULL.
An application can use the PhraseFinish notification to monitor what speech recognition is controlling the Voice Dictation object. An application should not rely on this notification for information about the recognition of its own commands. Most applications ignore this notification.
The notification is sent only to applications that set the dwFlags parameter of the IVoiceDictation::Register member function to the VDCTRF_ALLMESSAGES or VDCTRF_ALLBUTVUMETER value when the application registered to use voice commands on the site.