Partager via


Structure MODEMSETTINGS (mcx.h)

Contient des informations sur la configuration d’un modem.

Syntaxe

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;

Membres

dwActualSize

Taille des données réellement 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.

dwCallSetupFailTimer

Nombre maximal de secondes pendant lesquelles le modem doit attendre, une fois la numérotation terminée, pour indiquer qu’une connexion modem-à-modem a été établie. Si aucune connexion n’est établie dans cet intervalle, l’appel est supposé avoir échoué. Ce membre équivaut à inscrire S7 dans les modems compatibles® Hayes.

dwInactivityTimeout

Nombre maximal de secondes d’inactivité autorisées après l’établissement d’une connexion. Si aucune donnée n’est transmise ou reçue pendant cette période, l’appel est automatiquement terminé. Ce délai d’attente permet d’éviter des frais d’interurbain excessifs ou des frais de service en ligne si une application se verrouille de façon inattendue ou si l’utilisateur quitte.

dwSpeakerVolume

Niveau de volume du haut-parleur du moniteur lorsque le haut-parleur est allumé. Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
MDMVOL_HIGH
0x00000002
Volume élevé.
MDMVOL_LOW
0x00000000
Volume faible.
MDMVOL_MEDIUM
0x00000001
Volume moyen.
 

La structure MODEMDEVCAPS spécifie les volumes d’orateur pris en charge par un modem. Les volumes réels sont spécifiques au matériel.

dwSpeakerMode

Mode haut-parleur. Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
MDMSPKR_CALLSETUP
0x00000008
L’orateur est activé jusqu’à ce qu’une connexion soit établie.
MDMSPKR_DIAL
0x00000002
Le haut-parleur est activé jusqu’à ce qu’une connexion soit établie, sauf qu’il est désactivé pendant que le modem compose réellement.
MDMSPKR_OFF
0x00000001
L’orateur est toujours désactivé.
MDMSPKR_ON
0x00000004
L’orateur est toujours actif.

dwPreferredModemOptions

Options de modem demandées par l’application. Les modems locaux et distants négocient les options de modem pendant la configuration des appels ; ce membre spécifie la position de négociation initiale du modem local.

Le membre dwModemOptions de la structure MODEMDEVCAPS spécifie les options de modem prises en charge par le modem local. Pour obtenir la liste des options de modem, consultez la description de la structure MODEMDEVCAPS .

dwNegotiatedModemOptions

Options de modem qui sont réellement en vigueur. Ce membre est renseigné une fois qu’une connexion est établie et que les modems locaux et distants négocient les options de modem.

Le membre dwModemOptions de la structure MODEMDEVCAPS spécifie les options de modem prises en charge par le modem local. Pour obtenir la liste des options de modem, consultez la description de la structure MODEMDEVCAPS .

dwNegotiatedDCERate

Taux DCE en vigueur. Ce membre est renseigné une fois qu’une connexion est établie et que les modems locaux et distants négocient les modulations de modem.

abVariablePortion[1]

Informations facultatives définies par le fournisseur.

Configuration requise

   
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

MODEMDEVCAPS