Estructura MODEMSETTINGS (mcx.h)
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 |
|---|---|
|
Gran volumen. |
|
Bajo volumen. |
|
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.
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.
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 .
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) |