Properties

  • Article

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:

    ErrorControl

    FlowControl

    Compression

    Modulation

    SpeedNegotiation

    Pulse

    Tone

    Blind

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.

 

 

Send comments about this topic to Microsoft