See Also
 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
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:
 Copy Code
|
|
|---|---|
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 SndStopto 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 |