waveOutSelectPorts(3mms) — Subroutines
Name
waveOutSelectPorts --- Select the ports through which output of audio data is enabled. This function is meaningful only for a wave output device with multiple ports.
Syntax
#include <mme/mme_api.h>
MMRESULT waveOutSelectPorts(UINT uClassDeviceID,
DWORD dwPortMask);
Arguments
UINT uClassDeviceID
Identifies the waveform audio input device.
DWORD dwPortMask
Specifies one or more ports to be selected.
Description
The waveOutSelectPorts function enables audio data to be output through the ports specified by the dwPortMask parameter. The dwPortMask value is a bit mask; each bit set defines whether the corresponding port is to be selected. Mask values MME_PORTMASK_01 through MME_PORTMASK_32 are defined for use in specifying the port mask value.
Extensions
The waveOutSelectPorts function is a Digital extension to the Microsoft multimedia API specification.
Return Values
Returns MMSYSERR_NOERROR if the function is successful; otherwise, it returns one of the following error codes:
MMSYSERR_BADDEVICEID@T{ The specified device ID is out of range. T} MMSYSERR_NOTSUPPORTED@T{ This function is not supported for this device. T} MMSYSERR_INVALPARAM@T{ The value of dwPortMask is not valid, or the selection of the ports specified is not supported by this device. T}
Device-Specific Notes
The Alpha Baseboard wave audio output device supports several configurations of ports that are platform dependent. Port 1 (MME_PORTMASK_01) is the output side of the handset/headset RJ11 port as well as the output side of the headset jack. Port 2 (MME_PORTMASK_02) is the internal speaker port. The default selection is both ports enabled.
The Digital J300 wave audio output device supports two ports. Port 1 (MME_PORTMASK_01) corresponds to the 1/8-inch (3.45 mm) stereo output jack. Port 2 (MME_PORTMASK_02) corresponds to the output portion of the headset jack. The default selection is port 1.
The MSB (Microsoft Sound Board or equivalent) output device does not support multiple ports.
The Personal Workstation audio device two output ports. Both ports can be independently enabled and disabled. (See Appendix B of the Programmer’s Guide for more information.)
Port 1 (MME_PORTMASK1) corresponds to the PC Speaker. The PC Speaker port is used for mixing beeps generated by the system with other audio output.
Port 2 (MME_PORTMASK2) corresponds to the Record Monitor. Normal operation is with the Remote Monitor not enabled. This allows the playback audio stream to be heard through the speakers and headphones. If the Remote Monitor is enabled, then the record audio stream is heard through the speakers and headphones.