Structure MODEMDEVCAPS (mcx.h)

  • Article

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