Microsoft Speech SDK SAPI 5.1

---

ISpPhrase::Discard

ISpPhrase::Discard discards the requested data from a phrase object.

HRESULT Discard(
   DWORD   dwValueTypes
;)

Parameters

dwValueTypes

[in] Flags of type SPVALUETYPE indicating elements to discard. Multiple values may be combined.

Return values

Value	Description
S_OK	Function completed successfully.
E_INVALIDARG	dwValueTypes is not a valid value type flag.
FAILED(hr)	Appropriate error message.

Remarks

Applications that have no use for certain types of retained data, and will be persisting or serializing the phrase or result objects, may discard the unnecessary data. For example, an application performing offline transcription may need to retain only the audio and the final result. It can call ::Discard with SPDF_ALTERNATES to eliminate the alternate data (possibly including a large amount of private engine data).

Note that once retained audio is discarded, a call to ISpRecoResult::GetAudio will fail.

Example

The following code snippet illustrates the use of ISpRecoResult::Discard as inherited from ISpPhrase to discard the retained audio.

    HRESULT hr = S_OK;

    // .. get a recognition result object from the SR engine

    // discard audio
    hr = cpRecoResult->Discard(SPDF_AUDIO);
    // Check hr

    // .. serialize the "shrunken" result to the disk ...