PlaySound
.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
Essa função reproduz um som especificado por um evento Nome, recurso ou sistema arquivo.
Syntax
BOOL WINAPI PlaySound(
LPCSTR pszSound,
HMODULE hmod,
DWORD fdwSound
);
Parameters
pszSound
Ponteiro para uma seqüência de caracteres NULL-Terminated que especifica o som para Play. Se este parâmetro é NULL, qualquer jogando no momento em formato wave som é interrompido. Para parar um som non-waveform, especificar SND_PURGE in a fdwSound parâmetro.Três sinalizadores no fdwSound (SND_ALIAS, SND_FILENAME e SND_RESOURCE) determinam se o nome é interpretado como um alias para um evento sistema, um nome arquivo ou um identificador recurso. Se nenhuma desses sinalizadores forem especificados, PlaySound Procura o Registro ou o arquivo Win.ini para uma associação com o som especificado Nome. Se uma associação for encontrado, o som é reproduzido evento. Se nenhuma associação for encontrada no Registro, o nome é interpretado como um nome arquivo.
- hmod
Identificador para o arquivo executável que contém o recurso a ser carregado. Este parâmetro deve ser NULL, a menos que seja especificado em SND_RESOURCE fdwSound.
fdwSound
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_NOWAIT
Se o driver está ocupado, retorno imediatamente sem Tocando o som.
SND_RESOURCE
O pszSound parâmetro é um identificador recurso; hmod deve identificar a instância que contém o recurso. Ao criar o recurso, você deve identificá-lo como sendo do tipo de som wave, consulte Usando PlaySound com um identificador de recurso.
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
Windows Embedded CE não suporte a SND_ALIAS_ID e SND_PURGE sinalizadores para o fdwSound parâmetro. O som especificado por pszSound Deve encaixam disponível físico memória e ser reproduzidos por uma forma de onda instalada-áudio driver de dispositivo. PlaySound Pesquisa as pastas sistema de arquivos para o som de acordo com a ordem pesquisa que foi especificado, o OEM do dispositivo de destino. Se ele não é possível localizar o som especificado, PlaySound usa o evento sistema usar como padrão som entrada em vez disso. Se a função pode localizar a entrada usar como padrão sistema nem o usar como padrão som, ele não torna nenhum som e retorna FALSE.
Para obter exemplos de como usar o PlaySound função, consulte Usando a função PlaySound.
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 |