Partager via

MM_WOM_FORCESPEAKER (Windows Embedded CE 6.0)

  • Article

1/6/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

See Also

Reference

Waveform Audio Messages
waveOutMessage