SndOpen

4/8/2010

This function creates a sound handle based on a sound file.

Syntax

HRESULT SndOpen (
  LPCTSTR pszSoundFile,
  HSOUND* phSound
);

Parameters

• pszSoundFile
  [in] Sound filename.

• phSound
  [out] Upon successful completion, contains a properly initialized sound handle.

  You should close the returned sound handle using SndClose.

Return Value

The function returns S_OK if a sound handle was successfully opened, otherwise it will return a standard HRESULT error code.

Code Sample

The following code snippet shows how to open a sound handle from a sound file and play the sound:

const TCHAR* c_szMid= TEXT("\\Windows\\Loudest.mid");
HRESULT hr = SndOpen(c_szMid, &hSound);
// verify hr == S_OK.
hr = SndPlaySync(c_szMid, &hSound);
// verify hr == S_OK.
hr = SndClose(hSound);
// verify hr == S_OK.
SndStop(SND_SCOPE_PROCESS, NULL);

You should call function SndStop to terminate any asynchronous sounds on your process before your application exits.

Requirements

See Also

Concepts

Sounds Reference