Microsoft Speech Platform

---

ISpVoice::GetStatus

ISpVoice::GetStatus retrieves the current rendering and event status associated with this voice.

HRESULT GetStatus(
   SPVOICESTATUS   *pStatus,
   LPWSTR         **ppszLastBookmark
);

Parameters

pStatus

[out] Pointer to an SPVOICESTATUS structure which receives the status information. This pointer can be NULL if the caller does not want this information.

ppszLastBookmark

[out, string] Pointer to a pointer which receives a CoTaskMemAlloc allocated null-terminated string containing the text of the last bookmark reached. If there is no last bookmark, NULL will be returned. Applications calling this method must call CoTaskMemFree() to free the returned string. This pointer can be NULL if the caller does not want this information.

Return values

Value	Description
S_OK	Function completed successfully.
E_POINTER	Invalid pointer.
E_OUTOFMEMORY	Exceeded available memory.

Remarks

Because the SPVOICESTATUS structure is closely associated with audio device status, GetStatus will not return an active status for a voice speaking to an audio output stream.