Microsoft Speech SDK SAPI 5.1

---

ISpTranscript::GetTranscript

ISpTranscript::GetTranscript gets the current transcript. The string returned will be allocated by CoTaskMemAlloc and applications implementing this method must call CoTaskMemFree() to free memory associated with this string.

HRESULT GetTranscript(
   WCHAR   **ppszTranscript
);

Parameters

ppszTranscript

[out, string] A pointer to the null-terminated transcription string.

Return values

Value	Description
S_OK	Function completed successfully. ppszTranscript contains a CoTaskMemAllocated string.
E_OUTOFMEMORY	Exceeded available memory.
SPERR_UNINITIALIZED	Object has not been initialized.
E_POINTER	ppszTranscript is bad or invalid.
S_FALSE	No transcript is present and ppszTranscript will be NULL.
FAILED (hr)	Appropriate error message.

Example

The following code snippet illustrates the use of ISpTranscript::GetTranscript.

    HRESULT hr = S_OK;

    // Bind a stream to an existing wavefile
    hr = SPBindToFile( FILENAME, SPFM_READ_ONLY, &cpStream);
    // Check hr
  
    hr = cpStream.QueryInterface(&cpTranscript);
    // Check hr
 
    PWCHAR pwszTranscript;
    hr = cpTranscript->GetTranscript(&pwszTranscript);
    // Check hr