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 |