Condividi tramite


Struttura MODEMSETTINGS (mcx.h)

Contiene informazioni sulla configurazione di un modem.

Sintassi

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;

Members

dwActualSize

Dimensioni dei dati effettivamente restituiti all'applicazione, in byte. Questo membro può essere minore del membro dwRequiredSize se un'applicazione non ha allocato spazio sufficiente per la parte a lunghezza variabile della struttura.

dwRequiredSize

Numero di byte necessari per l'intera struttura MODEMDEVCAPS , inclusa la parte a lunghezza variabile.

dwDevSpecificOffset

Offset della parte definita dal provider della struttura, espressa in byte rispetto all'inizio della struttura.

dwDevSpecificSize

Dimensioni della parte definita dal provider della struttura, in byte.

dwCallSetupFailTimer

Il numero massimo di secondi di attesa del modem, dopo il completamento della composizione, indica che è stata stabilita una connessione modem-modem. Se in questo intervallo non viene stabilita una connessione, si presuppone che la chiamata non sia riuscita. Questo membro equivale a registrare S7 nei modem compatibili con Hayes®.

dwInactivityTimeout

Numero massimo di secondi di inattività consentiti dopo che è stata stabilita una connessione. Se non vengono trasmessi o ricevuti dati per questo periodo di tempo, la chiamata viene terminata automaticamente. Questo timeout viene usato per evitare addebiti eccessivi a lunga distanza o addebiti per i servizi online se un'applicazione si blocca in modo imprevisto o se l'utente lascia.

dwSpeakerVolume

Livello di volume dell'altoparlante del monitor quando l'altoparlante è acceso. Questo membro può essere uno dei valori seguenti.

Valore Significato
MDMVOL_HIGH
0x00000002
Volume elevato.
MDMVOL_LOW
0x00000000
Volume basso.
MDMVOL_MEDIUM
0x00000001
Volume medio.
 

La struttura MODEMDEVCAPS specifica i volumi altoparlanti supportati da un modem. I volumi effettivi sono specifici dell'hardware.

dwSpeakerMode

Modalità altoparlante. Questo membro può essere uno dei valori seguenti.

Valore Significato
MDMSPKR_CALLSETUP
0x00000008
L'altoparlante è attivo fino a quando non viene stabilita una connessione.
MDMSPKR_DIAL
0x00000002
L'altoparlante è acceso fino a quando non viene stabilita una connessione, ad eccezione del fatto che è spento mentre il modem è effettivamente in composizione.
MDMSPKR_OFF
0x00000001
L'altoparlante è sempre spento.
MDMSPKR_ON
0x00000004
L'altoparlante è sempre acceso.

dwPreferredModemOptions

Opzioni modem richieste dall'applicazione. I modem locali e remoti negoziano le opzioni del modem durante la configurazione delle chiamate; questo membro specifica la posizione negoziale iniziale del modem locale.

Il membro dwModemOptions della struttura MODEMDEVCAPS specifica le opzioni del modem supportate dal modem locale. Per un elenco delle opzioni modem, vedere la descrizione della struttura MODEMDEVCAPS .

dwNegotiatedModemOptions

Le opzioni del modem che sono effettivamente effettive. Questo membro viene compilato dopo che viene stabilita una connessione e i modem locali e remoti negoziano le opzioni modem.

Il membro dwModemOptions della struttura MODEMDEVCAPS specifica le opzioni del modem supportate dal modem locale. Per un elenco delle opzioni modem, vedere la descrizione della struttura MODEMDEVCAPS .

dwNegotiatedDCERate

Frequenza dce in vigore. Questo membro viene compilato dopo che viene stabilita una connessione e i modem locali e remoti negoziano le modularità del modem.

abVariablePortion[1]

Informazioni facoltative definite dal provider.

Requisiti

   
Client minimo supportato Windows XP
Server minimo supportato Windows Server 2003
Intestazione mcx.h (include Windows.h)

Vedi anche

MODEMDEVCAPS