Structure MODEMDEVCAPS (mcx.h)

Article
08/24/2023

Contient des informations sur les fonctionnalités d’un modem.

Syntaxe

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;

Membres

dwActualSize

Taille des données effectivement retournées à l’application, en octets. Ce membre peut être inférieur au membre dwRequiredSize si une application n’a pas alloué suffisamment d’espace pour la partie de longueur variable de la structure.

dwRequiredSize

Nombre d’octets requis pour l’ensemble de la structure MODEMDEVCAPS , y compris la partie de longueur variable.

dwDevSpecificOffset

Décalage de la partie définie par le fournisseur de la structure, en octets par rapport au début de la structure.

dwDevSpecificSize

Taille de la partie définie par le fournisseur de la structure, en octets.

dwModemProviderVersion

Version du fournisseur de services. Le format et l’utilisation de ce membre dépendent du fournisseur de services.

dwModemManufacturerOffset

Décalage d’une chaîne de texte qui contient le nom du fabricant du modem, en octets par rapport au début de la structure.

dwModemManufacturerSize

Longueur du nom du fabricant du modem, en octets. La chaîne n’est pas terminée par null.

dwModemModelOffset

Décalage d’une chaîne de texte qui contient le modèle du modem, en octets par rapport au début de la structure.

dwModemModelSize

Longueur du nom du modèle, en octets. La chaîne n’est pas terminée par null.

dwModemVersionOffset

Décalage d’une chaîne de texte qui donne la version et la révision du modem attaché, si le fournisseur peut déterminer les informations. Le décalage est spécifié en octets par rapport au début de la structure.

dwModemVersionSize

Longueur de la chaîne de version du modem, en octets. La chaîne n’est pas terminée par null.

dwDialOptions

Options de numérotation prises en charge par le périphérique modem. Ce membre peut être égal à zéro ou plusieurs des valeurs suivantes.

Valeur	Signification
DIALOPTION_BILLING 0x00000040	Le modem prend en charge l’attente du ton de facturation (bong).
DIALOPTION_DIALTONE 0x00000100	Le modem prend en charge l’attente d’une tonalité de numérotation.
DIALOPTION_QUIET 0x00000080	Le modem prend en charge l’attente de silence.

dwCallSetupFailTimer

Délai maximal de configuration des appels pris en charge par le modem, en secondes. Il s’agit de la plus grande valeur qui peut être spécifiée pour le membre correspondant de la structure MODEMSETTINGS .

dwInactivityTimeout

Délai d’inactivité maximal pris en charge par le modem, en dixièmes de secondes. Il s’agit de la plus grande valeur qui peut être spécifiée pour le membre correspondant de la structure MODEMSETTINGS .

dwSpeakerVolume

Paramètres de volume de l’orateur pris en charge par le modem. Ce membre peut être égal à zéro ou plusieurs des valeurs suivantes.

Valeur	Signification
MDMVOLFLAG_HIGH 0x00000004	Le modem prend en charge le volume élevé (MDMVOL_HIGH).
MDMVOLFLAG_LOW 0x00000001	Le modem prend en charge un volume faible (MDMVOL_LOW).
MDMVOLFLAG_MEDIUM 0x00000002	Le modem prend en charge le volume moyen (MDMVOL_MEDIUM).

dwSpeakerMode

Paramètres du mode haut-parleur pris en charge par le modem. Ce membre peut être égal à zéro ou plusieurs des valeurs suivantes.

Valeur	Signification
MDMSPKRFLAG_CALLSETUP 0x00000008	Le modem prend en charge le mode haut-parleur MDMSPKR_CALLSETUP.
MDMSPKRFLAG_DIAL 0x00000002	Le modem prend en charge le mode haut-parleur MDMSPKR_DIAL.
MDMSPKRFLAG_OFF 0x00000001	Le modem prend en charge le mode haut-parleur MDMSPKR_OFF.
MDMSPKRFLAG_ON 0x00000004	Le modem prend en charge le mode haut-parleur MDMSPKR_ON.

dwModemOptions

Options du modem. Ce membre peut être égal à zéro ou plusieurs des valeurs suivantes.

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)

Lorsque MODEMDEVCAPS est utilisé pour définir les options de modem, dans le cadre de la structure MODEMSETTINGS , ces valeurs sont utilisées comme suit.

Valeur	Signification
MDM_CCITT_OVERRIDE 0x00000040	Une fois définies, les modulations CCITT sont activées pour V.21 et V.22 ou V.23. Lorsqu’il est clair, les modulations de cloche sont activées pour 103 et 212A.
MDM_V23_OVERRIDE 0x00000400	Une fois définies, les modulations CCITT sont activées pour V.23. Lorsqu’elles sont claires, les modulations CCITT sont activées pour V.21 et V.22.

Pour que V.23 soit défini, MDM_CCITT_OVERRIDE et MDM_V23_OVERRIDE doivent être définis.

dwMaxDTERate

Débit DTE maximal en bits par seconde.

dwMaxDCERate

Débit DCE maximal en bits par seconde.

abVariablePortion[1]

Informations de longueur variable, y compris les chaînes et toutes les informations définies par le fournisseur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP
Serveur minimal pris en charge	Windows Server 2003
En-tête	mcx.h (inclure Windows.h)

Voir aussi

MODEMSETTINGS

Partager via