Função Beep (utilapiset.h)

Gera tons simples no alto-falante. A função é síncrona; ele executa uma espera alertável e não retorna o controle ao chamador até que o som seja concluído.

Sintaxe

BOOL Beep(
  [in] DWORD dwFreq,
  [in] DWORD dwDuration
);

Parâmetros

[in] dwFreq

A frequência do som, em hertz. Esse parâmetro deve estar no intervalo de 37 a 32.767 (0x25 até 0x7FFF).

[in] dwDuration

A duração do som, em milissegundos.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Há muito tempo, todos os computadores pc compartilhavam um chip de temporizador de intervalo programável 8254 comum para a geração de sons primitivos. A função Beep foi escrita especificamente para emitir um bipe nessa parte do hardware.

Nesses sistemas mais antigos, o mudo e os controles de volume não têm efeito sobre o Bipe; você ainda ouviria o tom. Para silenciar o tom, você usou os seguintes comandos:

net stop beep

sc config beep start= disabled

Desde então, as placas de som tornaram-se equipamentos padrão em quase todos os computadores pc. À medida que as placas de som se tornaram mais comuns, os fabricantes começaram a remover o antigo chip de temporizador dos computadores. Os chips também foram excluídos do design de computadores servidores. O resultado é que o Beep não funcionou em todos os computadores sem o chip. Tudo bem porque a maioria dos desenvolvedores passou a chamar a função MessageBeep que usa qualquer que seja o dispositivo de som padrão em vez do chip 8254.

Eventualmente, devido à falta de hardware para se comunicar, o suporte para Beep foi descartado no Windows Vista e no Windows XP 64-Bit Edition.

No Windows 7, Beep foi reescrito para passar o bipe para o dispositivo de som padrão para a sessão. Normalmente, esse é o cartão de som, exceto quando executado em Serviços de Terminal, nesse caso, o aviso sonoro é renderizado no cliente.

Exemplos

O exemplo a seguir demonstra o uso dessa função.

Beep( 750, 300 );

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	utilapiset.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll

Confira também

Funções do tratamento de erros

MessageBeep

Notificar o usuário