Compartilhar via

Função waveOutSetPlaybackRate (mmeapi.h)

  • Artigo

A função waveOutSetPlaybackRate define a taxa de reprodução para o dispositivo de saída waveform-audio especificado.

Sintaxe

MMRESULT waveOutSetPlaybackRate(
  HWAVEOUT hwo,
  DWORD    dwRate
);

Parâmetros

hwo

Identificador para o dispositivo de saída waveform-audio.

dwRate

Nova configuração de taxa de reprodução. Essa configuração é um multiplicador que indica a alteração atual na taxa de reprodução da configuração original criada. O multiplicador de taxa de reprodução deve ser um valor positivo.

A taxa é especificada como um valor de ponto fixo. A palavra de alta ordem contém a parte inteira com sinal do número e a palavra de ordem baixa contém a parte fracionária. Um valor de 0x8000 na palavra de baixa ordem representa metade e 0x4000 representa um quarto. Por exemplo, o valor 0x00010000 especifica um multiplicador de 1,0 (sem alteração de taxa de reprodução) e um valor de 0x000F8000 especifica um multiplicador de 15,5.

Valor retornado

Retorna MMSYSERR_NOERROR se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte.

Código de retorno Descrição
MMSYSERR_INVALHANDLE
 O identificador de dispositivo especificado é inválido.
MMSYSERR_NODRIVER
 Nenhum driver de dispositivo está presente.
MMSYSERR_NOMEM
 Não é possível alocar ou bloquear memória.
MMSYSERR_NOTSUPPORTED
 Não há suporte para a função .

Comentários

Alterar a taxa de reprodução não altera a taxa de amostragem, mas altera o tempo de reprodução. Nem todos os dispositivos dão suporte a alterações na taxa de reprodução. Para determinar se um dispositivo dá suporte a alterações na taxa de reprodução, use o sinalizador WAVECAPS_PLAYBACKRATE para testar o membro dwSupport da estrutura WAVEOUTCAPS (preenchido pela função waveOutGetDevCaps ).

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mmeapi.h (inclua Windows.h)
Biblioteca Winmm.lib
DLL Winmm.dll

Confira também

Áudio de forma de onda

Funções waveform