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 de retorno
Se a função for bem-sucedida, o valor retornado não será zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Observações
Há muito tempo, todos os computadores pc compartilhavam um chip de temporizador de intervalo programável comum 8254 para a geração de sons primitivos. A função Beep foi escrita especificamente para emitir um bipe nesse pedaço de hardware.
Nesses sistemas mais antigos, o mudo e os controles de volume não têm efeito sobre de bipe; você ainda ouviria o tom. Para silenciar o tom, você usou os seguintes comandos:
de bipe de parada de rede
sc config beep start= desabilitado
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 chip de temporizador antigo dos computadores. Os chips também foram excluídos do design de computadores servidores. O resultado é que do Beep não funcionava em todos os computadores sem o chip. Tudo bem porque a maioria dos desenvolvedores passou a chamar a função MessageBeep que usa qualquer dispositivo de som padrão em vez do chip 8254.
Eventualmente devido à falta de hardware com o qual se comunicar, o suporte para reproduzir som do alto-falante da placa-mãe foi descartado no Windows Vista e no Windows XP 64-Bit Edition.
No Windows 7, de bipe foi reescrita para passar o bipe para o dispositivo de som padrão da sessão. Normalmente, esse é o cartão de som, exceto quando executado nos Serviços de Terminal, nesse caso, o sinal sonoro é renderizado no cliente.
Exemplos
O exemplo a seguir demonstra o uso dessa função.
Beep( 750, 300 );
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows XP [aplicativos da área de trabalho | Aplicativos UWP] |
| servidor com suporte mínimo | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| da Plataforma de Destino | Windows |
| cabeçalho | utilapiset.h (inclua Windows.h) |
| biblioteca | Kernel32.lib |
| de DLL | Kernel32.dll |