Structure MODEMSETTINGS (mcx.h)

Article
08/24/2023

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.

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

Partager via