Idioma

TtsEngineSsml.GetOutputFormat(SpeakOutputFormat, IntPtr) Método

Definição

Retorna a melhor saída de áudio correspondente com suporte por uma determinada resposta do mecanismo de sintetização a uma solicitação ao mecanismo de sintetizador para o suporte de um formato de saída específico.

public:
 abstract IntPtr GetOutputFormat(System::Speech::Synthesis::TtsEngine::SpeakOutputFormat speakOutputFormat, IntPtr targetWaveFormat);
public abstract IntPtr GetOutputFormat(System.Speech.Synthesis.TtsEngine.SpeakOutputFormat speakOutputFormat, IntPtr targetWaveFormat);
abstract member GetOutputFormat : System.Speech.Synthesis.TtsEngine.SpeakOutputFormat * nativeint -> nativeint
Public MustOverride Function GetOutputFormat (speakOutputFormat As SpeakOutputFormat, targetWaveFormat As IntPtr) As IntPtr

Parâmetros

speakOutputFormat
SpeakOutputFormat

Membro válido da SpeakOutputFormat enumeração que indica o tipo de formato de saída de áudio solicitado.

targetWaveFormat
IntPtr

nativeint

Um ponteiro para uma struct configuração de detalhes que contém o tipo de formato de áudio solicitado pelo speakOutputFormat argumento.

Retornos

IntPtr

nativeint

Retorna uma instância válida IntPtr que se refere a uma struct informação detalhada sobre o formato de saída.

Exemplos

A implementação de exemplo abaixo valida as entradas selecionadas, usando-as se estiverem dentro de tolerâncias, caso contrário, usando valores padrão.

public IntPtr GetOutputFormat(SpeakOutputFormat format, IntPtr targetWaveFormat) {
    WaveFormat waveFormat = new WaveFormat();
    WaveFormat rq=new WaveFormat();
    Marshal.PtrToStructure(targetWaveFormat,rq);

    waveFormat.AvgBytesPerSec = AvgBytesPerSec Min < rq.AvgBytesPerSec && rq.AvgBytesPerSec < AvgBytesPerSecMax? rq.AvgBytesPerSec : 3200;
    waveFormat.BitsPerSample = BitsPerSampleMin < rq.AvgBytesPerSec && rq.BitsPerSample < BitsPerSampleMax ? rq.AvgBytesPerSec : 3200; 16;
    waveFormat.BlockAlign = 2;
    waveFormat.Channels = 1;
    waveFormat.FormatTag = 1;
    waveFormat.SamplesPerSec = 16000;
    waveFormat.Size = 0;

    IntPtr wfx = Marshal.AllocCoTaskMem(Marshal.SizeOf(waveFormat));
    Marshal.StructureToPtr(waveFormat, wfx, false);

    //Console.WriteLine ("GetOutputFormat called");
    return wfx;
}
internal struct WaveFormat {
    public Int16 FormatTag;
    public Int16 Channels;
    public int SamplesPerSec;
    public int AvgBytesPerSec;
    public Int16 BlockAlign;
    public Int16 BitsPerSample;
    public Int16 Size;
}

Comentários

A estrutura usada como targetWaveFormat e retornada pelo método deve ser compatível com a WAVEFORMATEX disponível no SAPI e o valor retornado deve ser alocado usando CoTaskMemAlloc.

A struct funcionalidade deve ser equivalente a:

internal struct WaveFormat
{
    public Int16 FormatTag;
    public Int16 Channels;
    public int SamplesPerSec;
    public int AvgBytesPerSec;
    public Int16 BlockAlign;
    public Int16 BitsPerSample;
    public Int16 Size;
}

Notas aos Implementadores

A herdação de objeto deve examinar o formato de TtsEngineSsml saída solicitado conforme especificado targetWaveFormat e retornar o formato mais próximo ao qual ele dá suporte.

Aplica-se a