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.
A version of this page is also available for
4/8/2010

This message is used to make sure that an audio stream is routed to the external speaker.

Syntax 

MM_WOM_FORCESPEAKER

wParam = (BOOL) 
bForce
  
  lParam = reserved

Parameters

bForce

A BOOL value that determines whether an audio stream should be routed to the speaker. Set to TRUE to route the stream to the speaker, and FALSE otherwise.

lParam

Reserved. Set to 0.

Return Value

None.

Remarks

In general, when the headset is plugged into a device, all audio should be routed to the headset by default. There are, however, certain sounds, such as the phone ring, that are always most appropriately played through the external speaker so it can always be heard.

Support for the MM_WOM_FORCESPEAKER message is driver dependent. The F-Sample platform code in the SDK implements this message. Hardware that supports selectively routing individual streams to the speaker is rare. So in practice, audio drivers typically keep a reference count of how many streams are to be routed to the speaker. If the number of streams is non-zero then all audio is routed to the speaker.

Requirements

Header audiosys.h
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also