Estructura MODEMSETTINGS (mcx.h)

Artículo
03/11/2023

Contiene información sobre la configuración de un módem.

Sintaxis

typedef struct _MODEMSETTINGS {
  DWORD dwActualSize;
  DWORD dwRequiredSize;
  DWORD dwDevSpecificOffset;
  DWORD dwDevSpecificSize;
  DWORD dwCallSetupFailTimer;
  DWORD dwInactivityTimeout;
  DWORD dwSpeakerVolume;
  DWORD dwSpeakerMode;
  DWORD dwPreferredModemOptions;
  DWORD dwNegotiatedModemOptions;
  DWORD dwNegotiatedDCERate;
  BYTE  abVariablePortion[1];
} MODEMSETTINGS, *PMODEMSETTINGS, *LPMODEMSETTINGS;

Members

dwActualSize

Tamaño de los datos devueltos realmente a la aplicación, en bytes. Este miembro puede ser menor que el miembro dwRequiredSize si una aplicación no asignó espacio suficiente para la parte de longitud variable de la estructura.

dwRequiredSize

Número de bytes necesarios para toda la estructura MODEMDEVCAPS , incluida la parte de longitud variable.

dwDevSpecificOffset

Desplazamiento de la parte definida por el proveedor de la estructura, en bytes con respecto al principio de la estructura.

dwDevSpecificSize

Tamaño de la parte definida por el proveedor de la estructura, en bytes.

dwCallSetupFailTimer

El número máximo de segundos que debe esperar el módem, una vez completada la marcación, para indicar que se ha establecido una conexión módem a módem. Si no se establece una conexión en este intervalo, se supone que se ha producido un error en la llamada. Este miembro es equivalente a registrar S7 en módems compatibles con Hayes®.

dwInactivityTimeout

Número máximo de segundos de inactividad permitido después de establecer una conexión. Si no se transmite ni recibe ningún dato durante este período de tiempo, la llamada finaliza automáticamente. Este tiempo de espera se usa para evitar cargos excesivos de larga distancia o cargos de servicio en línea si una aplicación bloquea inesperadamente o el usuario deja.

dwSpeakerVolume

Nivel de volumen del altavoz del monitor cuando el altavoz está activado. Este miembro puede ser uno de los valores siguientes.

Valor	Significado
MDMVOL_HIGH 0x00000002	Gran volumen.
MDMVOL_LOW 0x00000000	Bajo volumen.
MDMVOL_MEDIUM 0x00000001	Volumen medio.

La estructura MODEMDEVCAPS especifica los volúmenes de altavoz que admite un módem. Los volúmenes reales son específicos del hardware.

dwSpeakerMode

Modo de altavoz. Este miembro puede ser uno de los valores siguientes.

Valor	Significado
MDMSPKR_CALLSETUP 0x00000008	El altavoz está activado hasta que se establece una conexión.
MDMSPKR_DIAL 0x00000002	El altavoz está encendido hasta que se establece una conexión, excepto que está apagado mientras el módem está marcando realmente.
MDMSPKR_OFF 0x00000001	El altavoz siempre está desactivado.
MDMSPKR_ON 0x00000004	El orador siempre está activado.

dwPreferredModemOptions

Las opciones del módem solicitadas por la aplicación. Los módems locales y remotos negocian las opciones del módem durante la instalación de la llamada; este miembro especifica la posición de negociación inicial del módem local.

El miembro dwModemOptions de la estructura MODEMDEVCAPS especifica las opciones del módem compatibles con el módem local. Para obtener una lista de opciones de módem, consulte la descripción de la estructura MODEMDEVCAPS .

dwNegotiatedModemOptions

Las opciones del módem que realmente están en vigor. Este miembro se rellena después de establecer una conexión y los módems locales y remotos negocian las opciones del módem.

dwNegotiatedDCERate

Tasa de DCE en vigor. Este miembro se rellena después de establecer una conexión y los módems locales y remotos negocian modulaciones de módem.

abVariablePortion[1]

Información opcional definida por el proveedor.

Requisitos


Cliente mínimo compatible	Windows XP
Servidor mínimo compatible	Windows Server 2003
Encabezado	mcx.h (incluye Windows.h)

Consulte también

MODEMDEVCAPS

Share via