MM_WOM_FORCESPEAKER
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 |