Função waveOutSetPitch (mmeapi.h)

A função waveOutSetPitch define o pitch para o dispositivo de saída waveform-audio especificado.

Sintaxe

MMRESULT waveOutSetPitch(
  HWAVEOUT hwo,
  DWORD    dwPitch
);

Parâmetros

hwo

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

dwPitch

Nova configuração do multiplicador de tom. Essa configuração indica a alteração atual no pitch da configuração original criada. O multiplicador de tom deve ser um valor positivo.

O multiplicador de tom é especificado como um valor de ponto fixo. A palavra de alta ordem contém a parte inteira assinada do número e a palavra de baixa ordem 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 tom) e um valor de 0x000F8000 especifica um multiplicador de 15,5.

Retornar valor

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 o tom não altera a taxa de reprodução ou a taxa de exemplo, nem altera o tempo de reprodução. Nem todos os dispositivos dão suporte a alterações de pitch. Para determinar se o dispositivo dá suporte ao controle de tom, use o sinalizador WAVECAPS_PITCH para testar o membro dwSupport da estrutura WAVEOUTCAPS (preenchido pela função waveOutGetDevCaps ).

Requisitos

Requisito	Valor
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 de forma de onda