Skip to content

Latest commit

 

History

History
223 lines (172 loc) · 6.45 KB

ns-mcx-modemsettings.md

File metadata and controls

223 lines (172 loc) · 6.45 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NS:mcx._MODEMSETTINGS
MODEMSETTINGS (mcx.h)
Contains information about a modem's configuration.
*LPMODEMSETTINGS
*PMODEMSETTINGS
LPMODEMSETTINGS
LPMODEMSETTINGS structure pointer
MDMSPKR_CALLSETUP
MDMSPKR_DIAL
MDMSPKR_OFF
MDMSPKR_ON
MDMVOL_HIGH
MDMVOL_LOW
MDMVOL_MEDIUM
MODEMSETTINGS
MODEMSETTINGS structure
PMODEMSETTINGS
PMODEMSETTINGS structure pointer
_win32_modemsettings_str
base.modemsettings_str
mcx/LPMODEMSETTINGS
mcx/MODEMSETTINGS
mcx/PMODEMSETTINGS
base\modemsettings_str.htm
base
4648992b-eeeb-4a8d-8e08-7e80f0dc56ef
12/05/2018
*LPMODEMSETTINGS, *PMODEMSETTINGS, LPMODEMSETTINGS, LPMODEMSETTINGS structure pointer, MDMSPKR_CALLSETUP, MDMSPKR_DIAL, MDMSPKR_OFF, MDMSPKR_ON, MDMVOL_HIGH, MDMVOL_LOW, MDMVOL_MEDIUM, MODEMSETTINGS, MODEMSETTINGS structure, PMODEMSETTINGS, PMODEMSETTINGS structure pointer, _win32_modemsettings_str, base.modemsettings_str, mcx/LPMODEMSETTINGS, mcx/MODEMSETTINGS, mcx/PMODEMSETTINGS
mcx.h
Windows.h
Windows
Windows XP
Windows Server 2003
Windows
MODEMSETTINGS, *PMODEMSETTINGS, *LPMODEMSETTINGS
19H1
_MODEMSETTINGS
mcx/_MODEMSETTINGS
PMODEMSETTINGS
mcx/PMODEMSETTINGS
MODEMSETTINGS
mcx/MODEMSETTINGS
c++
APIRef
kbSyntax
HeaderDef
Mcx.h
MODEMSETTINGS

MODEMSETTINGS structure

-description

Contains information about a modem's configuration.

-struct-fields

-field dwActualSize

The size of the data actually returned to the application, in bytes. This member may be less than the dwRequiredSize member if an application did not allocate enough space for the variable-length portion of the structure.

-field dwRequiredSize

The number of bytes required for the entire MODEMDEVCAPS structure, including the variable-length portion.

-field dwDevSpecificOffset

The offset of the provider-defined portion of the structure, in bytes relative to the beginning of the structure.

-field dwDevSpecificSize

The size of the provider-defined portion of the structure, in bytes.

-field dwCallSetupFailTimer

The maximum number of seconds the modem should wait, after dialing is completed, for an indication that a modem-to-modem connection has been established. If a connection is not established in this interval, the call is assumed to have failed. This member is equivalent to register S7 in Hayes® compatible modems.

-field dwInactivityTimeout

The maximum number of seconds of inactivity allowed after a connection is established. If no data is either transmitted or received for this period of time, the call is automatically terminated. This time-out is used to avoid excessive long-distance charges or online service charges if an application unexpectedly locks up or the user leaves.

-field dwSpeakerVolume

The volume level of the monitor speaker when the speaker is on. This member can be one of the following values.

Value Meaning
MDMVOL_HIGH
0x00000002
High volume.
MDMVOL_LOW
0x00000000
Low volume.
MDMVOL_MEDIUM
0x00000001
Medium volume.
 

The MODEMDEVCAPS structure specifies the speaker volumes a modem supports. Actual volumes are hardware-specific.

-field dwSpeakerMode

The speaker mode. This member can be one of the following values.

Value Meaning
MDMSPKR_CALLSETUP
0x00000008
The speaker is on until a connection is established.
MDMSPKR_DIAL
0x00000002
The speaker is on until a connection is established, except that it is off while the modem is actually dialing.
MDMSPKR_OFF
0x00000001
The speaker is always off.
MDMSPKR_ON
0x00000004
The speaker is always on.

-field dwPreferredModemOptions

The modem options requested by the application. The local and remote modems negotiate modem options during call setup; this member specifies the initial negotiating position of the local modem.

The dwModemOptions member of the MODEMDEVCAPS structure specifies the modem options supported by the local modem. For a list of modem options, see the description of the MODEMDEVCAPS structure.

-field dwNegotiatedModemOptions

The modem options that are actually in effect. This member is filled in after a connection is established and the local and remote modems negotiate modem options.

The dwModemOptions member of the MODEMDEVCAPS structure specifies the modem options supported by the local modem. For a list of modem options, see the description of the MODEMDEVCAPS structure.

-field dwNegotiatedDCERate

The DCE rate in effect. This member is filled in after a connection is established and the local and remote modems negotiate modem modulations.

-field abVariablePortion

Optional provider-defined information.

-see-also

MODEMDEVCAPS