Estructura MODEMDEVCAPS (mcx.h)

Artículo
03/11/2023

Contiene información sobre las funcionalidades de un módem.

Sintaxis

typedef struct _MODEMDEVCAPS {
  DWORD dwActualSize;
  DWORD dwRequiredSize;
  DWORD dwDevSpecificOffset;
  DWORD dwDevSpecificSize;
  DWORD dwModemProviderVersion;
  DWORD dwModemManufacturerOffset;
  DWORD dwModemManufacturerSize;
  DWORD dwModemModelOffset;
  DWORD dwModemModelSize;
  DWORD dwModemVersionOffset;
  DWORD dwModemVersionSize;
  DWORD dwDialOptions;
  DWORD dwCallSetupFailTimer;
  DWORD dwInactivityTimeout;
  DWORD dwSpeakerVolume;
  DWORD dwSpeakerMode;
  DWORD dwModemOptions;
  DWORD dwMaxDTERate;
  DWORD dwMaxDCERate;
  BYTE  abVariablePortion[1];
} MODEMDEVCAPS, *PMODEMDEVCAPS, *LPMODEMDEVCAPS;

Miembros

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.

dwModemProviderVersion

Versión del proveedor de servicios. El formato y el uso de este miembro dependen del proveedor de servicios.

dwModemManufacturerOffset

Desplazamiento de una cadena de texto que contiene el nombre del fabricante del módem, en bytes relativos al principio de la estructura.

dwModemManufacturerSize

Longitud del nombre del fabricante del módem, en bytes. La cadena no termina en null.

dwModemModelOffset

Desplazamiento de una cadena de texto que contiene el modelo del módem, en bytes con respecto al principio de la estructura.

dwModemModelSize

Longitud del nombre del modelo, en bytes. La cadena no termina en null.

dwModemVersionOffset

Desplazamiento de una cadena de texto que proporciona la versión y revisión del módem adjunto, si el proveedor podría determinar la información. El desplazamiento se especifica en bytes con respecto al principio de la estructura.

dwModemVersionSize

Longitud de la cadena de versión del módem, en bytes. La cadena no termina en null.

dwDialOptions

Las opciones de marcado admitidas por el dispositivo módem. Este miembro puede ser cero o más de los siguientes valores.

Valor	Significado
DIALOPTION_BILLING 0x00000040	El módem admite la espera de tono de facturación (bong).
DIALOPTION_DIALTONE 0x00000100	El módem admite la espera de un tono de marcado.
DIALOPTION_QUIET 0x00000080	El módem admite la espera de silencio.

dwCallSetupFailTimer

Tiempo de espera máximo de configuración de llamadas admitido por el módem, en segundos. Este es el valor más grande que se puede especificar para el miembro correspondiente de la estructura MODEMSETTINGS .

dwInactivityTimeout

Tiempo de espera de inactividad máximo admitido por el módem, en décimos segundos. Este es el valor más grande que se puede especificar para el miembro correspondiente de la estructura MODEMSETTINGS .

dwSpeakerVolume

La configuración del volumen del altavoz compatible con el módem. Este miembro puede ser cero o más de los siguientes valores.

Valor	Significado
MDMVOLFLAG_HIGH 0x00000004	El módem admite un volumen elevado (MDMVOL_HIGH).
MDMVOLFLAG_LOW 0x00000001	El módem admite un volumen bajo (MDMVOL_LOW).
MDMVOLFLAG_MEDIUM 0x00000002	El módem admite el volumen medio (MDMVOL_MEDIUM).

dwSpeakerMode

La configuración del modo de altavoz compatible con el módem. Este miembro puede ser cero o más de los siguientes valores.

Valor	Significado
MDMSPKRFLAG_CALLSETUP 0x00000008	El módem admite el modo de altavoz MDMSPKR_CALLSETUP.
MDMSPKRFLAG_DIAL 0x00000002	El módem admite el modo de altavoz MDMSPKR_DIAL.
MDMSPKRFLAG_OFF 0x00000001	El módem admite el modo de altavoz MDMSPKR_OFF.
MDMSPKRFLAG_ON 0x00000004	El módem admite el modo de altavoz MDMSPKR_ON.

dwModemOptions

Opciones del módem. Este miembro puede ser cero o más de los siguientes valores.

MDM_BLIND_DIAL (0x00000200)

MDM_CCITT_OVERRIDE (0x00000040)

MDM_CELLULAR (0x00000008)

MDM_COMPRESSION (0x00000001)

MDM_DIAGNOSTICS (0x000000800)

MDM_ERROR_CONTROL (0x00000002)

MDM_FLOWCONTROL_HARD (0x00000010)

MDM_FLOWCONTROL_SOFT (0x00000020)

MDM_FORCED_EC (0x00000004)

MDM_SPEED_ADJUST (0x00000080)

MDM_TONE_DIAL (0x00000100)

MDM_V23_OVERRIDE (0x00000400)

Cuando MODEMDEVCAPS se usa para establecer opciones de módem, como parte de la estructura MODEMSETTINGS , estos valores se usan de la siguiente manera.

Valor	Significado
MDM_CCITT_OVERRIDE 0x00000040	Cuando se establece, las modulaciones CCITT están habilitadas para V.21 y V.22 o V.23. Cuando está claro, las modulaciones de campana están habilitadas para 103 y 212A.
MDM_V23_OVERRIDE 0x00000400	Cuando se establece, las modulaciones CCITT están habilitadas para V.23. Cuando está claro, las modulaciones CCITT están habilitadas para V.21 y V.22.

Para que se establezca V.23, se deben establecer tanto MDM_CCITT_OVERRIDE como MDM_V23_OVERRIDE.

dwMaxDTERate

Velocidad máxima de DTE en bits por segundo.

dwMaxDCERate

Velocidad máxima de DCE en bits por segundo.

abVariablePortion[1]

Información de longitud variable, incluidas las cadenas y cualquier información definida por el proveedor.

Requisitos

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

Consulte también

MODEMSETTINGS

Compartir a través de