IVoIPMediaMgr::PlaySound

  • Article

This method is used internally by the VoIP manager to play a ring tone.

HRESULT PlaySound( 
  BSTR bstrFilePath,
  INT_PTR hCallback
);

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

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.