|
|
/*++
Copyright (c) 1996-1999 Microsoft Corporation.
Component
Unimodem TSP Public Header
File
UNIMODEM.H
History
10/25/1997 JosephJ Created, taking stuff from nt50\tsp\public.h 01/29/1998 JosephJ Revised, allowing multiple diagnostics objects, as well as expanding the LINEDIAGNOSTICS_PARSEREC structure from 2 to 4 fields.
--*/
#ifndef _UNIMODEM_H_
#define _UNIMODEM_H_
#if _MSC_VER > 1000
#pragma once
#endif
#include <setupapi.h>
#ifdef __cplusplus
extern "C" {#endif
//====================================================================
// Supported TAPI Device Classes
//
//====================================================================
#define szUMDEVCLASS_COMM TEXT("comm")
#define szUMDEVCLASS_COMM_DATAMODEM TEXT("comm/datamodem")
#define szUMDEVCLASS_COMM_DATAMODEM_PORTNAME TEXT("comm/datamodem/portname")
#define szUMDEVCLASS_TAPI_LINE_DIAGNOSTICS TEXT("tapi/line/diagnostics")
//=========================================================================
//
// "comm"
//
//
// Supported APIS:
// lineGet/SetDevConfig
// lineConfigDialog
// lineConfigDialogEdit
//
// The associated configuration object is UMDEVCFG defined below...
//
//=========================================================================
// Device Setting Information
//
typedef struct // UMDEVCFGHDR
{ DWORD dwSize; DWORD dwVersion; // Set to MDMCFG_VERSION
WORD fwOptions; // One or more of the flags below...
#define UMTERMINAL_NONE 0x00000000
#define UMTERMINAL_PRE 0x00000001
#define UMTERMINAL_POST 0x00000002
#define UMMANUAL_DIAL 0x00000004
#define UMLAUNCH_LIGHTS 0x00000008 // Not supported on NT5.
WORD wWaitBong; // seconds to wait for the BONG character
// for modems that do not support detection
// of the BONG tone.
} UMDEVCFGHDR, *PUMDEVCFGHDR;
typedef struct // UMDEVCFG
{ UMDEVCFGHDR dfgHdr; COMMCONFIG commconfig;} UMDEVCFG, *PUMDEVCFG;
#define UMDEVCFG_VERSION 0x00010003 // Version number of structure
// How much to wait for a credit-card-bong if modem doesn't support it.
// (TODO: move this somewhere else!)
//
#define UMMIN_WAIT_BONG 0
#define UMMAX_WAIT_BONG 60
#define UMDEF_WAIT_BONG 8
#define UMINC_WAIT_BONG 2
//=========================================================================
//
// "comm/datamodem"
//
// Supported APIS:
// lineGetID Returns the structure below.
//
//=========================================================================
//=========================================================================
//
// "comm/datamodem/portname"
//
// Supported APIS:
// lineGetID The Varstring is of type ASCII string and
// contains the null-terminated name of the COMM port
// attached to the device, if there is one.
//
//=========================================================================
//=========================================================================
//
// "tapi/line/diagnostics"
//
// Supported APIS:
// lineGet/SetDevConfig: LINEDIAGNOSTICSCONFIG is the associated
// configuration object...
// lineGetID: LINEDIAGNOSTICS is the returned object.
//
//
//=========================================================================
//
// Many of the diagnostics-related structures and sub-structures defined
// below have a 4-DWORD header defined below:
//
//
typedef struct // LINEDIAGNOSTICSOBJECTHEADER
{ DWORD dwSig; // object-specific signature. All
// signatures defined here have
// prefix "LDSIG_", and are defined below:
#define LDSIG_LINEDIAGNOSTICSCONFIG 0xb2f78d82 // LINEDIAGNOSTICSCONFIG sig
#define LDSIG_LINEDIAGNOSTICS 0xf0c4d4e0 // LINEDIAGNOSTICS sig
#define LDSIG_RAWDIAGNOSTICS 0xf78b949b // see LINEDIAGNOSTICS defn.
#define LDSIG_PARSEDDIAGNOSTICS 0x16cf3208 // see LINEDIAGNOSTICS defn.
DWORD dwNextObjectOffset; // Offset from the start of this header to
// the next object if any (0 if none following).
// Depending on the type of object, this
// field may or may not be used.
DWORD dwTotalSize; // Total size of this object
DWORD dwFlags; // object-specific flags
DWORD dwParam; // object-specific data
} LINEDIAGNOSTICSOBJECTHEADER, *PLINEDIAGNOSTICSOBJECTHEADER;
//
// The following structure defines the diagnostics capabilities and
// curent settings of the device. It is accessed via
// lineGet/SetDevConfig("tapi/line/diagnostics");
//
typedef struct // LINEDIAGNOSTICSCONFIG
{ LINEDIAGNOSTICSOBJECTHEADER hdr; //
// hdr.dwSig must be set to LDSIG_LINEDIAGNOSTICSCONFIG
// hdr.dwNextObjectOffset will point to the next configuration object,
// if any.
// hdr.dwTotalSize must be set to the current size of this
// structure.
// hdr.dwFlags contains read only diagnostics capabilities --- one
// of the constants defined below ...
// This field is ignored when the structure is passed
// in a call to lineSetDevConfig
//
#define fSTANDARD_CALL_DIAGNOSTICS 0x1
// hdr.dwParam contains current diagnostics settings. One or more
// constants defined above -- indicate that the
// corresponding capability is enabled for
// the device.
} LINEDIAGNOSTICSCONFIG, *PLINEDIAGNOSTICSCONFIG;
//
// Diagnostic information is accessed by lineGetID("tapi/line/diagnostics"),
// with CALLSELECT_CALL. On return, the supplied VARSTRING will be filled
// in with one or more LINEDIAGNOSTICS structures defined below, and.
// potentially other kinds of structures (all with header
// LINEDIAGNOSTICSOBJECTHEADER).
//
// Note that this information can only be obtained if (a) diagnostics
// have been enabled by a previous call to
// lineSetDevConfig("tapi/line/diagnostics) and (b) a valid call handle
// exists. Typically this information is obtained just before
// deallocating the call.
//
// The LINEDIAGNOSTICS structure includes the raw
// diagnostics information returned by the device as well as summary
// information and variable-length arrays containing parsed information.
//
// All the diagnostic information in a particular LINEDIAGNOSTICS object
// is "domain ID" specific. The dwDomainID field of the structure defines the
// domain, or name space, from which any constants are taken. The
// currently Domain IDs are defined below, and have prefix "DOMAINID":
//
#define DOMAINID_MODEM 0x522aa7e1
#define DOMAINID_NULL 0x0
typedef struct // LINEDIAGNOSTICS
{ //
// The following 2 fields provide version and size informatio about
// this structure, as well as identify the domain (name space) of the
// diagnostics information applies to. All subsequent fields in the
// structure are domainID-specific.
//
LINEDIAGNOSTICSOBJECTHEADER hdr; //
// hdr.dwSig must be set to constant LDSIG_LINEDIAGNOSTICS
// hdr.dwNextObjectOffset will point to the next diagnostic object,
// if any.
// hdr.dwTotalSize contains the total size of this structure,
// including variable portion
// hdr.dwFlags is reserved and must be ignored.
// hdr.dwParam is set to the current sizeof(LINEDIAGNOSTICS) --
// used for versioning of the LINEDIAGNOSICS structure.
// Note that this does NOT include the size of the
// variable length portion.
DWORD dwDomainID; // Identifies the name space from which the
// interpretation of any constants are taken.
//
// The following 5 DWORD fields provide summary diagnostic information,
// obtained by analyzing all the diagnostic information.
//
DWORD dwResultCode; // dDomainID-specific LDRC_ constants defined below
DWORD dwParam1; // Params1-4 are dwResultCode-specific data items.
DWORD dwParam2; DWORD dwParam3; DWORD dwParam4;
//
// The remaining fields point to variable length objects containing
// parsed and unparsed (raw) diagnostics information.
//
// Each variable length object starts with a
// LINEDIAGNOSTICSOBJECTHEADER structure, referred to as "ohdr" in
// the documentation below.
//
DWORD dwRawDiagnosticsOffset; //
// Offset from the start of this structure
// to the start of an object containing
// the raw diagnostics output.
//
// ohdr.dwSig will be set to LDSIG_RAWDIAGNOSTICS
// ohdr.dwNextObjectOffset UNUSED and will be set to 0.
// ohdr.dwTotalSize is set to the total size of the
// raw-diagnostics object.
// ohdr.dwFlags is undefined and should be ignored.
// ohdr.dwParam is set to the size, in bytes of raw
// diagnostics data following ohdr.
//
// Note that ohdr.dwTotalSize will be equal to
// ( sizeof(LINEDIAGNOSTICSOBJECTHEADER)
// + ohdr.dwParam)
//
// The raw diagnostics bytes will be null terminated and
// the ohdr.dwParam includes the size of the terminating null.
// HOWEVER, the raw diagnostics may contain embedded nulls.
// For DEVCLASSID_MODEM, the bytestring will contain
// no embedded nulls and has the HTML-like tagged format
// defined in the AT#UD diagnostics specification.
//
// The following macros help extract and validate raw diagnostics
// information...
//
#define RAWDIAGNOSTICS_HDR(_plinediagnostics) \
((LINEDIAGNOSTICSOBJECTHEADER*) \ ( (BYTE*)(_plinediagnostics) \ + ((_plinediagnostics)->dwRawDiagnosticsOffset)))
#define IS_VALID_RAWDIAGNOSTICS_HDR(_praw_diagnostics_hdr) \
((_praw_diagnostics_hdr)->dwSig==LDSIG_RAWDIAGNOSTICS)
#define RAWDIAGNOSTICS_DATA(_plinediagnostics) \
( (BYTE*)(_plinediagnostics) \ + ((_plinediagnostics)->dwRawDiagnosticsOffset) \ + sizeof(LINEDIAGNOSTICSOBJECTHEADER))
#define RAWDIAGNOSTICS_DATA_SIZE(_praw_diagnostics_hdr) \
((_praw_diagnostics_hdr)->dwParam)
DWORD dwParsedDiagnosticsOffset; //
// Offset from the start of this structure
// to the start of an object containing
// parsed diagnostics output.
//
// ohdr.dwSig will be set to LDSIG_PARSEDDIAGNOSTICS
// ohdr.dwNextObjectOffset UNUSED and will be set to 0.
// ohdr.dwTotalSize is set to the total size of the
// parsed-diagnostics object.
// ohdr.dwFlags is undefined and should be ignored.
// ohdr.dwParam is set to the number of contiguous
// LINEDIAGNOSTICS_PARSEREC structures (defined below)
// following ohdr.
// Note that ohdr.dwTotalSize will be equal to
// ( sizeof(LINEDIAGNOSTICSOBJECTHEADER)
// + ohdr.dwParam*sizeof(LINEDIAGNOSTICS_PARSEREC))
//
// The following macros help extract and validate parsed diagnostics
// information...
//
#define PARSEDDIAGNOSTICS_HDR(_plinediagnostics) \
((LINEDIAGNOSTICSOBJECTHEADER*) \ ( (BYTE*)(_plinediagnostics) \ + ((_plinediagnostics)->dwParsedDiagnosticsOffset)))
#define PARSEDDIAGNOSTICS_DATA(_plinediagnostics) \
((LINEDIAGNOSTICS_PARSEREC*) \ ( (BYTE*)(_plinediagnostics) \ + ((_plinediagnostics)->dwParsedDiagnosticsOffset)\ + sizeof(LINEDIAGNOSTICSOBJECTHEADER)))
#define PARSEDDIAGNOSTICS_NUM_ITEMS(_pparsed_diagnostics_hdr) \
((_pparsed_diagnostics_hdr)->dwParam)
#define IS_VALID_PARSEDDIAGNOSTICS_HDR(_pparsed_diagnostics_hdr) \
((_pparsed_diagnostics_hdr)->dwSig==LDSIG_PARSEDDIAGNOSTICS)
} LINEDIAGNOSTICS, *PLINEDIAGNOSTICS;
//
// The following structure defines a keyword-value pair of parsed-diagnostic
// information.
//
typedef struct // LINEDIAGNOSTICS_PARSEREC
{
DWORD dwKeyType; //
// "Super key" -- identifying the type of key
//
DWORD dwKey; //
// This is domain-specific and key-type specific. For DEVCLASSID_MODEM,
// This will be one of the MODEMDIAGKEY_* constants
// defined below.
DWORD dwFlags; //
// Help to identify the meaning of dwValue
// One or more of the following flags:
// (1st 4 are mutually exclusive)
//
#define fPARSEKEYVALUE_INTEGER (0x1<<0)
// value is an integer literal
#define fPARSEKEYVALUE_LINEDIAGNOSTICSOBJECT (0x1<<1)
// value is the offset in bytes to a LINEDIGAGNOSTICS
// object which contains the information associated
// with this entry. The byte offset is from the start
// of the object containing the parsed information,
// not from start of the containing LINEDIAGNOSTICS object.
#define fPARSEKEYVALUE_ASCIIZ_STRING (0x1<<2)
// value is the offset in bytes to an ASCII
// null-terminated string. The byte offset is from the
// start of the object containing the parsed information,
// not from start of the containing LINEDIAGNOSTICS object.
#define fPARSEKEYVALUE_UNICODEZ_STRING (0x1<<3)
// value is the offset in bytes to a UNICODE
// null-terminated string. The byte offset is from the
// start of the object containing the parsed information,
// not from start of the containing LINEDIAGNOSTICS object.
DWORD dwValue; //
// This is dwKey specific. The documentation
// associated with each MODEMDIAGKEY_* constant definition
// precicely describes the content of its corresponding dwValue.
// See also dwFlags above.
//
} LINEDIAGNOSTICS_PARSEREC, *PLINEDIAGNOSTICS_PARSEREC;
// -----------------------------------------------------------------------------
// ANALOG MODEM SUMMARY DIAGNOSIC INFORMATION
// -----------------------------------------------------------------------------
//
// Diagnostics Result Codes (LDRC_*) for modems
//
#define LDRC_UNKNOWN 0
// The result code is unknown. Raw diagnostics information may be present,
// if so dwRawDiagnosticsOffset and dwRawDiagnosticsSize will be nonzero.
// dwParam1-4: unused and will be set to zero.
// Other codes are TBD.
// -----------------------------------------------------------------------------
// LINEDIAGNOSTICS_PARSEREC KeyType,
// key and value definitions for domainID DOMAINID_MODEM
// -----------------------------------------------------------------------------
//
// KEYTYPE
//
#define MODEM_KEYTYPE_STANDARD_DIAGNOSTICS 0x2a4d3263
// All the modem-domain-id key constants have prefix "MODEMDIAGKEY_". Both
// keys and values are based on the AT#UD diagnostic specification.
//
// Most of the values corresponding to the keys defined below are DWORD-sized
// bitfields or counters. A few of the values are offsets (from the start
// of the LINEDIAGNOSTICS structure) to variable-sized values. The formats
// of all values are documented directly after the corresponding key definition,
// and have prefix "MODEMDIAG_". Where useful, macros are provided which
// extract individual bits or bitfields out of the dwValue field. For example,
// see the macros associated with the MODEMDIAGKEY_V34_INFO key, which contains
// information extracted from the V.34 INFO structure.
#define MODEMDIAGKEY_VERSION 0x0
// Value: DWORD. HiWord represents major version;
// LoWord represents minor version;
// Following Macros may be used to extract the hi- and low- version numbers.
// from the parserec's .dwValue field...
//
#define MODEMDIAG_MAJORVER(_ver) ((HIWORD) (_ver))
#define MODEMDIAG_MINORVER(_ver) ((LOWORD) (_ver))
#define MODEMDIAGKEY_CALL_SETUP_RESULT 0x1
// Value: Call Setup Result codes based on on Table 2 of the
// AT#UD specification....
#define MODEMDIAG_CALLSETUPCODE_NO_PREVIOUS_CALL 0x0
//
// Modem log has be en cleared since any previous calls...
//
#define MODEMDIAG_CALLSETUPCODE_NO_DIAL_TONE 0x1
//
// No dial tone detected.
//
#define MODEMDIAG_CALLSETUPCODE_REORDER_SIGNAL 0x2
//
// Reorder signal detected, network busy.
//
#define MODEMDIAG_CALLSETUPCODE_BUSY_SIGNAL 0x3
//
// Busy signal detected
//
#define MODEMDIAG_CALLSETUPCODE_NO_SIGNAL 0x4
//
// No recognized signal detected.
//
#define MODEMDIAG_CALLSETUPCODE_VOICE 0x5
//
// Analog voice detected
//
#define MODEMDIAG_CALLSETUPCODE_TEXT_TELEPHONE_SIGNAL 0x6
//
// Text telephone signal detected (V.18)
//
#define MODEMDIAG_CALLSETUPCODE_DATA_ANSWERING_SIGNAL 0x7
//
// Data answering signal detected (e.g. V.25 ANS, V.8 ANSam)
//
#define MODEMDIAG_CALLSETUPCODE_DATA_CALLING_SIGNAL 0x8
//
// Data calling signal detected (e.g. V.25 CT, V.8 CI).
//
#define MODEMDIAG_CALLSETUPCODE_FAX_ANSWERING_SIGNAL 0x9
//
// Fax answering signal detected (e.g. T.30 CED, DIS).
//
#define MODEMDIAG_CALLSETUPCODE_FAX_CALLING_SIGNAL 0xa
//
// Fax calling signal detected (e.g. T.30 CNG)
//
#define MODEMDIAG_CALLSETUPCODE_V8BIS_SIGNAL 0xb
//
// V.8bis signal detected.
//
#define MODEMDIAGKEY_MULTIMEDIA_MODE 0x2
// Value: Multimedia mode, based on Table 3 of the AT#UD specification...
#define MODEMDIAG_MMMODE_DATA_ONLY 0x0
#define MODEMDIAG_MMMODE_FAX_ONLY 0x1
#define MODEMDIAG_MMMODE_VOICE_ONLY 0x2
#define MODEMDIAG_MMMODE_VOICEVIEW 0x3
#define MODEMDIAG_MMMODE_ASVD_V61 0x4
#define MODEMDIAG_MMMODE_ASVD_V34Q 0x5
#define MODEMDIAG_MMMODE_DSVD_MT 0x6
#define MODEMDIAG_MMMODE_DSVD_1_2 0x7
#define MODEMDIAG_MMMODE_DSVD_70 0x8
#define MODEMDIAG_MMMODE_H324 0x9
#define MODEMDIAG_MMMODE_OTHER_V80 0xa
#define MODEMDIAGKEY_DTE_DCE_INTERFACE_MODE 0x3
// Value: DTE-DCE interface mode, based on Table 4 of the AT#UD specication
// ...
#define MODEMDIAG_DCEDTEMODE_ASYNC_DATA 0x0
#define MODEMDIAG_DCEDTEMODE_V80_TRANSPARENT_SYNC 0x1
#define MODEMDIAG_DCEDTEMODE_V80_FRAMED_SYNC 0x2
#define V8_CM_STRING 0x4
// Value: offset from the start of the LINEDIAGNOSTICS structure to
// the V.8 CM octet string, same format as V.25ter Annex A.
// The offset points to a contiguous region of memory who
// TODO: define parsed-versions of V.8 CM and V.8 JM octet strings, not
// covered in the information returned in PARSEREC
#define MODEMDIAGKEY_RECEIVED_SIGNAL_POWER 0x10
// Value: Received signal power level, in -dBm.
#define MODEMDIAGKEY_TRANSMIT_SIGNAL_POWER 0x11
// Value: Transmit signal power level, in -dBm.
#define MODEMDIAGKEY_NOISE_LEVEL 0x12
// Value: Estimated noise level, in -dBM.
#define MODEMDIAGKEY_NORMALIZED_MSE 0x13
// Value: Normalized Mean Squared error. JosephJ: TODO: Of what?
#define MODEMDIAGKEY_NEAR_ECHO_LOSS 0x14
// Value: Near echo loss, in units of dB
#define MODEMDIAGKEY_FAR_ECHO_LOSS 0x15
// Value: Far echo loss, in units of dB
#define MODEMDIAGKEY_FAR_ECHO_DELAY 0x16
// Value: Far echo delay, in units of ms.
#define MODEMDIAGKEY_ROUND_TRIP_DELAY 0x17
// Value: Round trip delay, in units of ms.
#define MODEMDIAGKEY_V34_INFO 0x18
// Value: V.34 INFO bitmap, based on Table 5 of the AT#UD specifiction.
// This DWORD value encodes 32 bits extracted from the V.34 INFO bitmap.
// The following Macros extract specific V.34 INFO bit ranges out of
// the 32-bit value:
//
// 10/30/1997 JosephJ: TODO what exactly are these? Also, what
// does 20;0, 50;0 below mean?
#define MODEMDIAG_V34_INFO0_20_0(_value) (((_value)>>30) & 0x3)
//
// INFO0 bit 20;0
//
#define MODEMDIAG_V34_INFOc_79_88(_value) (((_value)>>20) & 0x3ff)
//
// INFOc bit 79-88
//
#define MODEMDIAG_V34_INFOc_PRE_EMPHASIS(_value) (((_value)>>16) & 0xf)
//
// Pre-emphasis field, selected by the symbol rate chosen.
// INFOc bits 26-29 or 35-38 or 44-47 or 53-56 or 62-65 or 71-74
//
#define MODEMDIAG_V34_INFOa_26_29(_value) (((_value)>>12) & 0xf)
//
// INFOa bits 26-29
//
#define MODEMDIAG_V34_INFO_MP_50_0(_value) (((_value)>>10) & 0x3)
//
// MP bit 50;0
//
#define MODEMDIAG_V34_INFOa_40_49(_value) (((_value)>>0) & 0x3ff)
//
// INFOa bits 40-49
//
#define MODEMDIAGKEY_TRANSMIT_CARRIER_NEGOTIATION_RESULT 0x20
// Value: based on Table 6 of the AT#UD specification
// TODO: fill out...
#define MODEMDIAGKEY_RECEIVE_CARRIER_NEGOTIATION_RESULT 0x21
// Value: based on Table 6 of the AT#UD specification
// TODO: fill out...
#define MODEMDIAGKEY_TRANSMIT_CARRIER_SYMBOL_RATE 0x22
// Value: Transmit carrier symbol rate.
#define MODEMDIAGKEY_RECEIVE_CARRIER_SYMBOL_RATE 0x23
// Value: Receive carrier symbol rate.
#define MODEMDIAGKEY_TRANSMIT_CARRIER_FREQUENCY 0x24
// Value: Transmit carrier frequency TODO: units? Hz?
#define MODEMDIAGKEY_RECEIVE_CARRIER_FREQUENCY 0x25
// Value: Transmit carrier frequency TODO: units? Hz?
#define MODEMDIAGKEY_INITIAL_TRANSMIT_CARRIER_DATA_RATE 0x26
// Value: Initial transmit carrier data rate. TODO: units? /sec?
#define MODEMDIAGKEY_INITIAL_RECEIVE_CARRIER_DATA_RATE 0x27
// Value: Initial receive carrier data rate. TODO: units? /sec?
#define MODEMDIAGKEY_TEMPORARY_CARRIER_LOSS_EVENT_COUNT 0x30
// Value: Temporary carrier loss event count
#define MODEMDIAGKEY_CARRIER_RATE_RENEGOTIATION_COUNT 0x31
// Value: Carrier rate renegotiation event count
#define MODEMDIAGKEY_CARRIER_RETRAINS_REQUESTED 0x32
// Value: Carrier retrains requested
#define MODEMDIAGKEY_CARRIER_RETRAINS_GRANTED 0x33
// Value: Carrier retrains granted.
#define MODEMDIAGKEY_FINAL_TRANSMIT_CARRIER_RATE 0x34
// Value: final carrier transmit rate TODO: units? /sec?
#define MODEMDIAGKEY_FINAL_RECEIVE_CARRIER_RATE 0x35
// Value: final carrier receive rate TODO: units? /sec?
#define MODEMDIAGKEY_PROTOCOL_NEGOTIATION_RESULT 0x40
// Value: Protocol negotiation result code, based on
// Table 7 of the AT#UD diagnostics specification...
#define MODEMDKAGKEY_ERROR_CONTROL_FRAME_SIZE 0x41
// Value: Error control frame size. TODO: units? bytes?
#define MODEMDIAGKEY_ERROR_CONTROL_LINK_TIMEOUTS 0x42
// Value: Error control link timeouts. TODO: time or count?
#define MODMEDIAGKEY_ERROR_CONTROL_NAKs 0x43
// Value: Error control NAKs
#define MODEMDIAGKEY_COMPRESSION_NEGOTIATION_RESULT 0x44
// Value: Compression negotiation result, based on
// Table 8 of the AT#UD spec.
//
// TODO: add specific constant definitions here...
#define MODEMDIAGKEY_COMPRESSION_DICTIONARY_SIZE 0x45
// Value: compression dictionary size. TODO: size? bytes?
#define MODEMDIAGKEY_TRANSMIT_FLOW_CONTROL 0x50
// Value: Transmit flow control, defined by
// one of the following constants:
#define MODEMDIAG_FLOW_CONTROL_OFF 0x0
//
// No flow control
//
#define MODEMDIAG_FLOW_CONTROL_DC1_DC3 0x2
//
// DC1/DC3 (XON/XOFF) flow control
//
#define MODEMDIAG_FLOW_CONTROL_RTS_CTS 0x3
//
// RTS/CTS (V.24 ckt 106/133) flow control: TODO verify that latter
// is the same as RTS/CTS.
//
#define MODEMDIAGKEY_RECEIVE_FLOW_CONTROL 0x51
// Value: Receive flow control, defined by the above
// (MODEMDiG_FLOW_CONTROL_*) constants.
#define MODEMDIAGKEY_DTE_TRANSMIT_CHARACTERS 0x52
// Value: Transmit characters obtained from DTE
#define MODEMDIAGKEY_DTE_RECEIVED_CHARACTERS 0x53
// Value: Received characters sent to DTE
#define MODEMDIAGKEY_DTE_TRANSMIT_CHARACTERS_LOST 0x54
// Value: Transmit characters lost (data overrun errors from DTE)
#define MODEMDIAGKEY_DTE_RECEIVED_CHARACTERS_LOST 0x55
// Value: Transmit characters lost (data overrun errors to DTE)
#define MODEMDIAGKEY_EC_TRANSMIT_FRAME_COUNT 0x56
// Value: Error control protocol transmit frame count
#define MODEMDIAGKEY_EC_RECEIVED_FRAME_COUNT 0x57
// Value: Error control protocol received frame count
#define MODEMDIAGKEY_EC_TRANSMIT_FRAME_ERROR_COUNT 0x58
// Value: Error control protocol transmit frame error count
#define MODEMDIAGKEY_EC_RECEIVED_FRAME_ERROR_COUNT 0x59
// Value: Error control protocol received frame error count
#define MODEMDIAGKEY_TERMINATION_CAUSE 0x60
// Value: Termination cause, based on Table 9-10 of the AT#UD
// specification.
#define MODEMDIAGKEY_CALL_WAINTING_EVENT_COUNT 0x61
// Value: Call wainting event count.
// TODO: Define specific constants.
//
// KEYTYPE
//
#define MODEM_KEYTYPE_AT_COMMAND_RESPONSE 0x5259091c
//
// The values are responses to specific AT commands. This type is relevant
// only to AT ("Hayes(tm) compatible") modems.
// The key (one of the MODEMDIAGKEY_ATRESP_* constants ) identifies the
// command.
//
#define MODEMDIAGKEY_ATRESP_CONNECT 0x1
// Value: Connect response string.
// This will be a null-terminated ascii string.
// ========================================================================
// UNIMODEM DEVICE-SPECIFIC returned for lineGetDevCaps
// The following structure is located at dwDevSpecificOffset into
// the LINEDEVCAPS structure returned by lineGetDevCaps.
//
typedef struct // DEVCAPS_DEVSPECIFIC_UNIMODEM
{ DWORD dwSig; //
// This will be set to 0x1;
DWORD dwKeyOffset; //
// This is the offset from the start of THIS structure, to
// a null-terminated ASCI (not UNICODE) string giving
// the device's driver key.
//
// WARNING: this is present for compatibility reasons. Applications
// are STRONGLY discouraged to use this information, because the
// location of the driver key could change on upgrade, so if
// applications save away this key, the application could fail
// on upgrade of the OS.
//
} DEVCAPS_DEVSPECIFIC_UNIMODEM, *PDEVCAPS_DEVSPECIFIC_UNIMODEM;
// ========================================================================
typedef struct // ISDN_STATIC_CONFIG
{ DWORD dwSig; //
// Must be set to dwSIG_ISDN_STATIC_CONFIGURATION
//
#define dwSIG_ISDN_STATIC_CONFIGURATION 0x877bfc9f
DWORD dwTotalSize; //
// Total size of this structure, including variable portion, if any.
//
DWORD dwFlags; // reserved
DWORD dwNextHeaderOffset; // reserved
DWORD dwSwitchType; //
// One of the dwISDN_SWITCH_* values below.
//
#define dwISDN_SWITCH_ATT1 0 // AT&T 5ESS Customm
#define dwISDN_SWITCH_ATT_PTMP 1 // AT&T Point to Multipoint
#define dwISDN_SWITCH_NI1 2 // National ISDN 1
#define dwISDN_SWITCH_DMS100 3 // North3ern Telecom DMS-100 NT1
#define dwISDN_SWITCH_INS64 4 // NTT INS64 - (Japan)
#define dwISDN_SWITCH_DSS1 5 // DSS1 (Euro-ISDN)
#define dwISDN_SWITCH_1TR6 6 // 1TR6 (Germany)
#define dwISDN_SWITCH_VN3 7 // VN3 (France)
#define dwISDN_SWITCH_BELGIUM1 8 // Belgian National
#define dwISDN_SWITCH_AUS1 9 // Australian National TPH 1962
#define dwISDN_SWITCH_UNKNOWN 10 // Unknown
DWORD dwSwitchProperties; //
// One or more fISDN_SWITCHPROP_* flags below
//
// Note the following three are exclusive, so only one can be
// set at a time:
#define fISDN_SWITCHPROP_US (0x1<<0) // Uses DN/SPID
#define fISDN_SWITCHPROP_MSN (0x1<<1) // Uses MSN
#define fISDN_SWITCHPROP_EAZ (0x1<<2) // Uses EAX
#define fISDN_SWITCHPROP_1CH (0x1<<3) // Only one channel.
DWORD dwNumEntries; //
// The number of channels OR MSNs.
// The numbers and possibly IDs are specified in the following
// two offsets.
//
DWORD dwNumberListOffset; //
// Offset in BYTES from the start of this structure to a
// UNICODE multi-sz set of strings representing numbers.
// There will dwNumChannels entries.
//
// The interpretation of these numbers is switch-property-specific,
// and is as follows:
// US: Directory Number.
// MSN: MSN Number
// EAZ: EAZ Number.
DWORD dwIDListOffset; //
// Offset in BYTES from the start of this structure to a
// UNICODE multi-sz set of strings representing IDs.
// There will dwNumChannels entries.
//
// The interpretation of these IDs is switch-property-specific and
// is as follows:
// US: SPID.
// MSN: Not used and should be set to 0.
// EAZ: EAZ
//
// variable length portion, if any, follows...
//
} ISDN_STATIC_CONFIG;
typedef struct // ISDN_STATIC_CAPS
{ DWORD dwSig; //
// Must be set to dwSIG_ISDN_STATIC_CAPS
//
#define dwSIG_ISDN_STATIC_CAPS 0xd11c5587
DWORD dwTotalSize; //
// Total size of this structure, including variable portion, if any.
//
DWORD dwFlags; // reserved
DWORD dwNextHeaderOffset; // reserved
DWORD dwNumSwitchTypes; DWORD dwSwitchTypeOffset; //
// Offset to switch types, which is a DWORD array of types.
//
DWORD dwSwitchPropertiesOffset; //
// Offset to a DWORD array of properties of the corresponding switch.
//
DWORD dwNumChannels; //
// The number of channels supported.
//
DWORD dwNumMSNs; //
// The number of MSNs supported.
//
DWORD dwNumEAZ; //
// The number of EAZs supported.
//
//
// variable length portion, if any, follows...
//
} ISDN_STATIC_CAPS;
typedef struct // MODEM_CONFIG_HEADER
{ DWORD dwSig; DWORD dwTotalSize; DWORD dwNextHeaderOffset; DWORD dwFlags;
} MODEM_CONFIG_HEADER;
typedef struct // MODEM_PROTOCOL_CAPS
{
MODEM_CONFIG_HEADER hdr; //
// hdr.dwSig must be set to dwSIG_MODEM_PROTOCOL_CAPS
// hdr.dwFlags are reserved and should be ignored by app.
//
#define dwSIG_MODEM_PROTOCOL_CAPS 0x35ccd4b3
DWORD dwNumProtocols; //
// The number of protocols supported.
//
DWORD dwProtocolListOffset; //
// Offset to a DWORD array of protocols supported.
//
//
// variable length portion, if any, follows...
//
} MODEM_PROTOCOL_CAPS;
typedef struct _PROTOCOL_ITEM { DWORD dwProtocol; // Protocol Supported
DWORD dwProtocolNameOffset; // Offset from beggining of MODEM_PROTOCOL_CAPS structure
// to NULL terminated friendly name of the protocol.
} PROTOCOL_ITEM, *PPROTOCOL_ITEM;
//=========================================================================
//
// Modem install wizard structures and flags
//
//=========================================================================
#define UM_MAX_BUF_SHORT 32
#define UM_LINE_LEN 256
#define MIPF_NT4_UNATTEND 0x1
// Take the information about what modem to install
// from the unattended.txt file
#define MIPF_DRIVER_SELECTED 0x2
// The modem driver is selected, just register
// and install it
// Unattended install parameters
typedef struct _tagUMInstallParams{ DWORD Flags; // Flags that specify the unattended mode
WCHAR szPort[UM_MAX_BUF_SHORT]; // Port on which to install the modem
WCHAR szInfName[MAX_PATH]; // for NT4 method, inf name
WCHAR szSection[UM_LINE_LEN]; // for NT4 method, section name
} UM_INSTALLPARAMS, *PUM_INSTALLPARAMS, *LPUM_INSTALLPARAMS;
// This structure is the private structure that may be
// specified in the SP_INSTALLWIZARD_DATA's PrivateData field.
typedef struct tagUM_INSTALL_WIZARD{ DWORD cbSize; // set to the size of the structure
DWORD Reserved1; // reserved, must be 0
DWORD Reserved2; // reserved, must be 0
LPARAM Reserved3; // reserved, must be 0
UM_INSTALLPARAMS InstallParams; // parameters for the wizard
} UM_INSTALL_WIZARD, *PUM_INSTALL_WIZARD, *LPUM_INSTALL_WIZARD;
//=========================================================================
//
// Modem properties defines
//
//=========================================================================
#define REGSTR_VAL_DEVICEEXTRAPAGES TEXT("DeviceExtraPages") // Property pages provided by the device manufacturer
typedef BOOL (APIENTRY *PFNADDEXTRAPAGES)(HDEVINFO,PSP_DEVINFO_DATA,LPFNADDPROPSHEETPAGE,LPARAM);
#ifdef __cplusplus
}#endif
#endif // _UNIMODEM_H_
|
