Compartilhar via


ISpTTSEngine::Speak

Windows Mobile Not SupportedWindows Embedded CE Supported

9/8/2008

Este método reproduz áudio dados e eventos. O chamador fornece o texto a ser processado, em uma lista vinculada do texto afirma atributo XML fragmentos COM associado. Também fornecido na chamar são o formato saída para processamento de texto e o site saída para que o mecanismo irá gravar áudio dados e eventos.

Syntax

HRESULT Speak(
  DWORD dwSpeakFlags,
  REFGUID rguidFormatId,
  const WaveFormatEx* pWaveFormatEx,
  const SPVTEXTFRAG* pTextFragList,
  ISpTTSEngineSite* pOutputSite
);

Parameters

  • dwSpeakFlags
    [no] Sinalizadores definidos para o SPEAKFLAGS ) enumeração. Todos os valores que não seja SPF_NLP_SPEAK_PUNC são mascarados logoff. Se SPF_NLP_SPEAK_PUNC for definida, o mecanismo TTS deve falar todos os pontos. De exemplo, "Isso é uma frase". devem ser expandidos para " é uma frase período ".
  • rguidFormatId
    [no] Identificador formato fluxo descrevendo o formato saída. Esse formato é garantido ser que o mecanismo TTS especificado como com suporte em um chamar anterior para ISpTTSEngine::GetOutputFormat.

    Value Description

    SPDFID_Text

    Saída na forma de texto. Mecanismos não são exigido para suporte neste formato. Se eles suporte, eles não são exigido para fazer algo específico com ele. Ele é fornecido apenas para depuração fins.

    SPDFID_WaveFormatEx

    Saída na forma de um WAVEFORMATEX estrutura).

  • pWaveFormatEx
    [no] Ponteiro para um WAVEFORMATEX estrutura que descreve o formato saída. Esse valor é NULL se rguidFormatId é definido como SPDFID_Text.
  • pTextFragList
    [no] Ponteiro para uma lista vinculada do SPVTEXTFRAG Estruturas identificando fragmentos de texto para sintetizar e processar.
  • pOutputSite
    [no] Ponteiro para uma implementação objeto ISpTTSEngineSite Para que o mecanismo deve gravar áudio dados e eventos.

Return Value

A seguinte tabela mostra os valores possíveis de retorno.

Value Description

S_OK

Function completed successfully.

FAILED(hr)

Mensagem de erro apropriadas

Requirements

Header sapiddk.h, sapiddk.idl
Library sapilib.lib
Windows Embedded CE Windows CE .NET 4.1 and later

See Also

Reference

ISpTTSEngine
SAPI Interfaces