Properties
The Properties entry defines a set of modem properties that are contained in a binary structure. Unimodem uses this modem properties structure to respond to the GetCommProperties function.
Note The ProCalc tool, which is included in the Microsoft Windows Driver Kit (WDK), should be used to create this entry. For more information about ProCalc, see Using ProCalc. For more information about using ProCalc to create this entry, see Data Profile.
Format
Eight DWORD hexadecimal values.
Examples
HKR,, Properties, 1, 80,01,00,00, ff,00,00,00, ff,00,00,00, 07,00,00,00, 0f,00,00,00, f7,03,00,00, 00,c2,01,00, 40,38,00,00
Remarks
The Properties entry can be described in a C structure as follows:
typedef struct ModemProp {
DWORD DialOptions; // bitmap of supported options
DWORD CallSetupFailTimeout; // Maximum value in seconds
DWORD InactivityTimeout; // Maximum value in units
// specified by InactivityScale
DWORD SpeakerVolume; // bitmap of supported values
DWORD SpeakerMode; // bitmap of supported values
DWORD ModemOptions; // bitmap of supported values
DWORD MaxDTERate; // Maximum value in bit/sec
DWORD MaxDCERate; // Maximum value in bit/sec
} ModemProp
The members of this structure are defined as follows:
DialOptions
Specifies a bit vector of the embedded commands that the modem supports in dial commands:Option name Value Description DIALOPTION_DIALBILLING
0x00000040
Supports wait for bongtone "&"
DIALOPTION_DIALQUIET
0x00000080
Supports wait for quiet "@"
DIALOPTION_DIALDIALTONE
0x00000100
Supports wait for dial tone "W"
Note These characters ('&', '@', 'W') cannot be changed. If they are not the same for a given modem, these settings cannot be used at all. For example, if the modem supports "Wait for bongtone", but uses '!' instead of '&', it must not set DIALOPTION_DIALBILLING. Unimodem will proceed as if it does not support "Wait for bongtone".
CallSetupFailTimeout
Specifies the maximum value allowed for the call setup timer. The call setup time is the delay between dialing and responding to an incoming carrier signal after initial connection. If the modem does not detect a carrier within the specified time, the modem hangs up. If the modem does not have this feature, set this value to 0.For more information, see CallSetupFailTimer.
InactivityTimeout
Specifies the maximum value that is allowed for the data inactivity timer. The inactivity time-out is the allowed period of time after which an inactive modem times out and hangs up. If the modem does not have this feature, set this value to 0.Multiply this number by the value in InactivityScale to convert to the maximum value in seconds.
For more information, see InactivityTimeout.
SpeakerVolume
Specifies a bit vector of possible speaker volume settings defined as follows:Speaker volume setting Value Supports low speaker volume
0x00000001
Supports medium speaker volume
0x00000002
Supports high speaker volume
0x00000004
For more information, see the corresponding entries described in SpeakerVolume.
SpeakerMode
Specifies a bit vector of possible speaker mode settings defined as follows:Speaker mode setting Value Supports speaker mode off
0x00000001
Supports speaker mode dial
0x00000002
Supports speaker mode on
0x00000004
Supports speaker mode setup
0x00000008
For more information, see the corresponding entries described in SpeakerMode.
ModemOptions
Specifies a bit vector of settings that can be changed using lineSetDevConfig. The bit values are defined as follows:Modem option Value Supports enabling/disabling of data compression negotiation
0x00000001
Supports enabling/disabling of error control protocol negotiation
0x00000002
Supports enabling/disabling of forced error control
0x00000004
Supports enabling/disabling of a cellular protocol
0x00000008
Supports enabling/disabling of hardware flow control
0x00000010
Supports enabling/disabling of software flow control
0x00000020
Supports CCITT/Bell toggling
0x00000040
Supports enabling/disabling of speed negotiation
0x00000080
Supports tone and pulse dialing
0x00000100
Supports blind dialing
0x00000200
Supports CCITT V.21-V.22/CCITT V.23 toggling
0x00000400
Supports modem diagnostics (for example, AT#UD)
0x00000800
For more information, see the corresponding entries described in the following topics:
MaxDTERate
Specifies the maximum data transmission speed, in bits per second, that is supported between the modem and the computer.
MaxDCERate:
Specifies the maximum data transmission speed, in bits per second, that is supported between the two modems.