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 |