ISpTranscript::GetTranscript (SAPI 5.3)

Microsoft Speech API 5.3

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(
   LPWSTR    **ppszTranscript
);

Parameters

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

Return values

Value
S_OK
E_OUTOFMEMORY
SPERR_UNINITIALIZED
E_POINTER
S_FALSE
FAILED (hr)

Example

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

  
// Declare local identifiers:
HRESULT                    hr = S_OK;
CComPtr<ISpStream>         cpStream;
CComPtr<ISpTranscript>     cpTranscript;
PWCHAR                     pwszTranscript;

// Bind a stream to an existing wavefile (assumes
// existence of the file "C:\VoiceToFile.wav").
hr = SPBindToFile(L"C:\\VoiceToFile.wav", SPFM_CREATE_ALWAYS, &cpStream;);

if (SUCCEEDED(hr))
{
   hr = cpStream.QueryInterface(&cpTranscript;);
}

if (SUCCEEDED(hr))
{
   hr = cpTranscript->GetTranscript(&pwszTranscript;);
}

if (SUCCEEDED(hr))
{
   // Do stuff here.
}

// Release system resources.
::CoTaskMemFree(&pwszTranscript;);