sndPlaySound
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Esta função executa uma única forma de onda som. Para Play múltiplo sons simultaneamente, use o waveOut * funções na Waveform Audio API.
Syntax
BOOL sndPlaySound(
LPCTSTR lpszSoundName,
UINT fuSound
);
Parameters
- lpszSoundName
Ponteiro longo para um seqüência de caracteres NULL-Terminated que especifica o som para Play. Este parâmetro pode ser qualquer uma entrada no Registro Win.ini que identifica um sistema ou som ou ela pode ser o nome de uma forma de onda-arquivo de áudio. (Se a função não localizar a entrada, o parâmetro é tratado como um nome arquivo.) Se este parâmetro é NULL, qualquer som atualmente em execução está parado.
fuSound
Sinalizadores para reproduzir o som. A seguinte tabela mostra os valores possíveis.Valor Descrição SND_ALIAS
O pszSound parâmetro é um sistema-evento alias no Registro ou o arquivo Win.ini. Não use com SND_FILENAME ou SND_RESOURCE.
SND_ASYNC
O som é reproduzido de forma assíncrona e PlaySound retorna imediatamente após iniciar o som. Para finalizar uma de forma assíncrona reproduzido de forma de onda som, chamar PlaySound Com pszSound Definir como NULL.
SND_FILENAME
O pszSound parâmetro é um nome arquivo.
SND_LOOP
O som é reproduzido repetidamente até PlaySound é chamado novamente com o pszSound parâmetro definido como NULL. Você também deve especificar o sinalizador SND_ASYNC para indicar um assíncrono som evento.
SND_MEMORY
Um som arquivo do evento é carregado no memória RAM. O parâmetro especificado por pszSound deve apontar para uma imagem de um som na memória.
SND_NODEFAULT
Nenhuma usar como padrão som evento é usado. Se o som não puder ser encontrado, PlaySound Retorna silenciosamente sem tocando o usar como padrão som.
SND_NOSTOP
O som especificado será evento lucro para outro som evento que já está tocando. Se um som não pode ser executado porque o recurso necessário para gerar esse som ocupado está jogando outro som, a função retorna imediatamente FALSE sem Tocando o som solicitada.
Se este sinalizador não for especificado, PlaySound tentar parar o som atualmente em execução para que o dispositivo possa ser usado para Play o novo som.
SND_SYNC
A reprodução síncrona de um som evento. PlaySound Retorna após o som evento for concluída.
Return Value
TRUE indica sucesso. FALSE indica falha.
Remarks
Os controles sinalizador SND_NOSTOP como o atual chamar para sndPlaySound se comporta se um chamar anterior ainda está tocando.
Se o som especificado não puder ser encontrado, sndPlaySound Reproduz o usar como padrão sistema som. Se não houver nenhuma entrada usar como padrão sistema no arquivo Win.ini ou Registro ou usar como padrão o som não pode ser encontrado, a função não faz nenhum som e retorna FALSE.
O som especificado deve caber na disponível físico memória e ser reproduzidos por uma forma de onda instalada-áudio driver de dispositivo.
Requirements
| Header | mmsystem.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |