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 |
---|---|
|
Volume élevé. |
|
Volume faible. |
|
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.
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) |