ISpTTSEngine::GetOutputFormat
.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 obtém informações sobre um formato específico saída. O mecanismo TTS deve examinar o formato saída solicitada e recuperar um ponteiro para o com suporte formato que for mais próximo que solicitou.
Syntax
HRESULT GetOutputFormat(
const GUID* pTargetFmtId,
const WAVEFORMATEX* pTargetWaveFormatEx,
GUID* pOutputFormatId,
WAVEFORMATEX** ppCoMemOutputWaveFormatEx
);
Parameters
pTargetFmtId
[no] Ponteiro para o identificador para o formato saída solicitada. Os valores possíveis são: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).
- pTargetWaveFormatEx
[no] Ponteiro para um WAVEFORMATEX estrutura que descreve o formato saída solicitada. Esse valor é NULL se pTargetFmtId é definido como SPDFID_Text.
pOutputFormatId
[out] Ponteiro para o identificador para o mecanismo-com suporte formato saída. Os valores possíveis são:Value Description SPDFID_Text
Saída na forma de texto. Se esse valor é recuperada, NULL deve ser recuperada no ppCoMemOutputWaveFormatEx.
SPDFID_WaveFormatEx
Saída na forma de um WAVEFORMATEX estrutura).
- ppCoMemOutputWaveFormatEx
[out] Endereço de um ponteiro para um WAVEFORMATEX estrutura definindo o mecanismo-com suporte formato saída. O chamador deve alocar espaço para a estrutura usando CoTaskMemAlloc.
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 |