IVoIPMediaMgr::PlaySound (Windows CE 5.0)
This method is used internally by the VoIP manager to play a ring tone.
HRESULT PlaySound( BSTR bstrFilePath,INT_PTRhCallback);
Parameters
- bstrFilePath
[in] File name of and path to the file to play. - hCallback
[in] Handle to a Win32-based application event that was created with the Win32-based application CreateEvent function. When the ring tone is done playing, PlaySound calls the Win32-based application function SetEvent with this handle to indicate to the VoIP manager that the ring tone has completed.
Return Values
If the HRESULT value passed to SUCCEEDED macro returns TRUE, the method succeeded. Otherwise, the method failed.
Remarks
The VoIP manager plays sound in a loop, over which it maintains control at all times. It uses the media manager to actually play the ring tone and depends on the PlaySound method to signal an event when the tone has been played. The VoIP manager uses this event to determine when the tone is done playing so that it can do other processing, and possibly play the tone again if necessary.
Requirements
OS Versions: Windows CE .NET 4.2 and later.
Header: Voipmediamanager.idl.
Link Library: Voipguid.lib.
See Also
VoIP Application Interface Layer Architecture | VoIP Application Interface Layer Reference | CreateEvent | IVoIPMediaMgr::StopSound | IVoIPMgr | SetEvent
Send Feedback on this topic to the authors