Share via


Note

Please see Azure Cognitive Services for Speech documentation for the latest supported speech solutions.

Microsoft Speech Platform

ISpRecognizer::DisplayUI

ISpRecognizer::DisplayUI displays the requested graphical user interface (GUI) component from the underlying speech recognition (SR) engine. We recommend that you avoid using this method. This call will fail when using Microsoft engines.

<pre IsFakePre="true" xmlns="http://www.w3.org/1999/xhtml"> <strong>[local] HRESULT DisplayUI(</strong> <strong>HWND</strong> <em>hwndParent</em>, <strong>LPCWSTR</strong> *<em>pszTitle</em>, <strong>LPCWSTR</strong> *<em>pszTypeOfUI</em>, <strong>void</strong> *<em>pvExtraData</em>, <strong>ULONG</strong> <em>cbExtraData</em> <strong>);</strong> </pre>

Parameters

  • hwndParent
    [in] Specifies the handle of the parent window.
  • pszTitle
    [in] Address of a null-terminated string containing the window title. Set this value to NULL to indicate that the SR engine should use its default window title for this UI type. 
  • pszTypeOfUI
    [in] Address of a null-terminated string containing the UI type information.
  • pvExtraData
    [in] Additional information for the call. The SR engine implementer dictates the format and use of the data provided.
  • cbExtraData
    [in] Size, in bytes, of the contents of pvExtraData. The SR engine implementer dictates the format and usage of the data provided.

Return Values

Value Description
S_OK Function completed successfully.
S_FALSE The UI is supported but not with the current run-time environment or parameters.
FAILED(hr) Appropriate error message.