Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure provides an interface to programmatically edit or retrieve the Unimodem device configuration.

Syntax

typedef struct _UNIMDM_CHG_DEVCFG {
  DWORD 
dwCommand; 
  LPCWSTR 
lpszDeviceClass; 
  LPVARSTRING 
lpDeviceConfig; 
  DWORD 
dwOption; 
  DWORD 
dwValue; 
} UNIMDM_CHG_DEVCFG; 

Members

dwCommand

Value that controls whether the device configuration is retrieved or edited. The following table shows possible values for dwCommand.

Value Description

UNIMDM_CMD_CHG_DEVCFG

Command to edit the device configuration.

UNIMDM_CMD_GET_DEVCFG

Command to retrieve the device configuration.

lpszDeviceClass

Pointer to a null-terminated string that identifies a device class name.

lpDeviceConfig

Pointer to the device configuration to be retrieved or edited.

dwOption

Value that selects the option to be retrieved or changed in the device configuration. The following table shows possible values for dwOption.

Value Description

UNIMDM_OPT_BAUDRATE

The baud rate at which the Unimodem operates. Valid values are the CBR_* values that are defined in Winbase.h.

UNIMDM_OPT_BYTESIZE

The size of the UNIMDM_CHG_DEVCFGstructure in bytes.

UNIMDM_OPT_PARITY

The valid values are defined in Winbase.h.

UNIMDM_OPT_STOPBITS

The valid values are defined in Winbase.h.

UNIMDM_OPT_WAITBONG

The number of seconds to wait for a prompt tone.

UNIMDM_OPT_MDMOPTIONS

Selects the Unimodem option to be retrieved or changed. Valid values are the MDM_* values defined in Mcx.h. Currently, the supported options are MDM_BLIND_DIAL, MDM_FLOWCONTROL_HARD, MDM_FLOWCONTROL_SOFT, and MDM_SPEED_ADJUST. MDM_SPEED_ADJUST enables automatic baud rate detection on a DCC client connection.

UNIMDM_OPT_TIMEOUT

The number of seconds before a call time-out failure.

UNIMDM_OPT_TERMOPTIONS

The terminal dialing options. Valid values are defined in Netui.h.

UNIMDM_OPT_DIALMOD

The dial modifier. The dwValueparameter must be type LPCWSTR.

dwValue

If dwCommandis UNIMDM_CMD_CHG_DEVCFG, this member should contain the new option value. If dwCommandis UNIMDM_CMD_GET_DEVCFG, this member will receive the current option value.

Remarks

Changes are applied to the DevConfigstructure only and do not affect the current state of the associated line device.

The following code example demonstrates how to use this structure.

Copy Code
PUNIMDM_CHG_DEVCFG pUniMdmChgDevCfg;
// allocate and set up pUniMdmChgDevCfg fields 
pUniMdmChgDevCfg->dwCommand = UNIMDM_CMD_CHG_DEVCFG;
rc = lineDevSpecific(
		hLine,
		0,
		NULL,
		pUniMdmChgDevCfg,
		sizeof(UNIMDM_CHG_DEVCFG));

Requirements

Header unimodem.h
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

UNIMODEM_INFO