ISpVoice::Speak
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Este método fala um seqüência de caracteres ou um arquivo de texto, qual é a operação principal das ISpVoice interface.
Syntax
HRESULT Speak(
const WCHAR* pwcs,
DWORD dwFlags,
ULONG* pulStreamNumber
);
Parameters
- pwcs
[no] Ponteiro para uma seqüência de caracteres NULL-Terminated (marcação XML possivelmente contendo) para ser sintetizada. Este valor pode ser NULL quando dwFlags está definido como SPF_PURGEBEFORESPEAK indicando que os dados restantes ser sintetizada devem ser descartados. Se dwFlags está definido para SPF_IS_FILENAME, esse valor deve apontar para um caminho totalmente qualificado NULL-Terminated, para um arquivo.
- dwFlags
[no] Sinalizadores usados para controle o processo processamento para esse chamar. Valores possíveis são definidos pela enumeração de SPEAKFLAGS.
- pulStreamNumber
[out] Ponteiro para o atual fluxo de entrada número associado com esse fala solicitação. Cada tempo um seqüência de caracteres é falado, UM associado número transmitir é recuperado. Eventos enfileirado voltar para o aplicativo relacionado a este seqüência de caracteres irá conter este número.
Return Value
A seguinte tabela mostra os valores possíveis de retorno.
| Value | Description |
|---|---|
S_OK |
Function completed successfully. |
E_INVALIDARG |
Um ou mais argumentos estão inválido. |
E_POINTER |
Ponteiro inválido. |
E_OUTOFMEMORY |
Disponível excedido memória. |
SPERR_INVALID_FLAGS |
Sinalizadores inválidos especificados para esta operação. |
SPERR_DEVICE_BUSY |
Tempo limite ocorreu em chamada síncrona. |
Remarks
Normalmente, pulStreamNumber será 1. No entanto, se fala vários assíncrono (ou SpeakStream) chamadas são recebidas e deve ser enfileirado, o número transmitir será incrementado para cada chamar.
Requirements
| Header | sapi.h, sapi.idl |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |