SndOpen

9/9/2008

Essa função cria um som identificador com base em um arquivo de som.

Syntax

HRESULT SndOpen (
  LPCTSTR pszSoundFile,
  HSOUND* phSound
);

Parameters

• pszSoundFile
  [no] Nome do arquivo de som.

• phSound
  [out] Após bem-sucedido conclusão, contém um corretamente inicializado som identificador.

  Você deve fechar o som retornado identificador usando SndClose.

Return Value

A função Retorna S_OK se um som identificador foi aberto com êxito, ele retornará um padrão caso contrário código de erro HRESULT.

Exemplo de código

Um som identificador é um identificador evento que é em um estado SET quando não está tocando um som e em um estado reset quando estiver tocando um som. O seguinte trecho de código mostra como esperar por um som para reproduzir concluir:

const TCHAR* c_szMid= TEXT("\\Windows\\Loudest.mid");
HRESULT hr = SndOpen(c_szMid, &hSound);
// verify hr == S_OK.
hr = SndPlayAsync(hSound, 0);
// verify hr == S_OK.
// do some work here and then wait for the sound to finish playing.
WaitForSingleObject(hSound, INFINITE);
hr = SndClose(hSound);
// verify hr == S_OK.
SndStop(SND_SCOPE_PROCESS, NULL);

Você deve chamar função SndStop para finalizar qualquer assíncrono sons no seu processo antes de que sai seu aplicativo.

Requirements

Header	soundfile.h
Windows Embedded CE	Windows CE 5.0 and later
Windows Mobile	Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later, Windows Mobile 6 Standard and later

See Also

Concepts

Sounds Reference