Microsoft Speech SDK

Speech Automation 5.1

---

Interface: ISpeechRecoResult

DiscardResultInfo Method

The DiscardResultInfo method discards the requested data from a phrase object.

Applications that have no use for certain types of retained data, and will be persisting or serializing the phrase or result objects, may discard unnecessary data.

For example, an application performing offline transcription may need to retain only the audio and the final result. It can remove the alternates with object.DiscardResultInfo(SPDF_ALTERNATES) to eliminate the alternate data (possibly including a large amount of private engine data). Once the result information is discarded, all attempts to access that data will be unsuccessful. For example, once retained audio has been discarded, a call to ISpeechRecoResult.Audio will fail.

ISpeechRecoResult.DiscardResultInfo(
     ValueTypes As SpeechDiscardType
)

Parameters

ValueTypes

Flags indicating elements to discard. Multiple values may be combined with logical operands.

Return Value

None.

Example

The following snippet demonstrates discarding the audio portion of the recognition. Retaining audio is explicitly set in the second line. After a successful recognition and a valid RecoResult, the snippet speaks back the recognition. The retained audio is discarded immediately and the next attempt at speaking that audio fails with an SPERR_NO_AUDIO_DATA.

Set RecoResult = New SpSharedRecoContext
RecoResult.RetainedAudio = SRAORetainAudio

'Speech processing code goes here

RecoResult.SpeakAudio
RecoResult.DiscardResultInfo (SDTAudio)
RecoResult.SpeakAudio