Share via


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

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