Struttura MODEMDEVCAPS (mcx.h)

Articolo
08/24/2023

Contiene informazioni sulle funzionalità di un modem.

Sintassi

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;

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, in byte rispetto all'inizio della struttura.

dwDevSpecificSize

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

dwModemProviderVersion

Versione del provider di servizi. Il formato e l'uso di questo membro dipendono dal provider di servizi.

dwModemManufacturerOffset

Offset di una stringa di testo contenente il nome del produttore del modem, in byte rispetto all'inizio della struttura.

dwModemManufacturerSize

Lunghezza del nome del produttore del modem, in byte. La stringa non viene terminata con null.

dwModemModelOffset

Offset di una stringa di testo che contiene il modello del modem, in byte rispetto all'inizio della struttura.

dwModemModelSize

Lunghezza del nome del modello, in byte. La stringa non viene terminata con null.

dwModemVersionOffset

Offset di una stringa di testo che fornisce la versione e la revisione del modem collegato, se il provider potrebbe determinare le informazioni. L'offset viene specificato in byte rispetto all'inizio della struttura.

dwModemVersionSize

Lunghezza della stringa di versione del modem, in byte. La stringa non viene terminata con null.

dwDialOptions

Opzioni di composizione supportate dal dispositivo modem. Questo membro può essere zero o più dei valori seguenti.

Valore	Significato
DIALOPTION_BILLING 0x00000040	Il modem supporta l'attesa del tono di fatturazione (bong).
DIALOPTION_DIALTONE 0x00000100	Il modem supporta l'attesa di un tono di chiamata.
DIALOPTION_QUIET 0x00000080	Il modem supporta l'attesa per la quiete.

dwCallSetupFailTimer

Timeout massimo di configurazione delle chiamate supportato dal modem, in secondi. Si tratta del valore più grande che può essere specificato per il membro corrispondente della struttura MODEMSETTINGS .

dwInactivityTimeout

Timeout massimo di inattività supportato dal modem, in decimi di secondi. Si tratta del valore più grande che può essere specificato per il membro corrispondente della struttura MODEMSETTINGS .

dwSpeakerVolume

Impostazioni del volume dell'altoparlante supportate dal modem. Questo membro può essere zero o più dei valori seguenti.

Valore	Significato
MDMVOLFLAG_HIGH 0x00000004	Il modem supporta volume elevato (MDMVOL_HIGH).
MDMVOLFLAG_LOW 0x00000001	Il modem supporta volume basso (MDMVOL_LOW).
MDMVOLFLAG_MEDIUM 0x00000002	Il modem supporta il volume medio (MDMVOL_MEDIUM).

dwSpeakerMode

Impostazioni della modalità altoparlante supportate dal modem. Questo membro può essere zero o più dei valori seguenti.

Valore	Significato
MDMSPKRFLAG_CALLSETUP 0x00000008	Il modem supporta la modalità altoparlante MDMSPKR_CALLSETUP.
MDMSPKRFLAG_DIAL 0x00000002	Il modem supporta la modalità altoparlante MDMSPKR_DIAL.
MDMSPKRFLAG_OFF 0x00000001	Il modem supporta la modalità altoparlante MDMSPKR_OFF.
MDMSPKRFLAG_ON 0x00000004	Il modem supporta la modalità altoparlante MDMSPKR_ON.

dwModemOptions

Opzioni del modem. Questo membro può essere zero o più dei valori seguenti.

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)

Quando MODEMDEVCAPS viene usato per impostare le opzioni del modem, come parte della struttura MODEMSETTINGS , questi valori vengono usati come indicato di seguito.

Valore	Significato
MDM_CCITT_OVERRIDE 0x00000040	Se impostato, le configurazioni CCITT sono abilitate per V.21 e V.22 o V.23. Se chiaro, le modulazioni della campana sono abilitate per 103 e 212A.
MDM_V23_OVERRIDE 0x00000400	Se impostato, le configurazioni CCITT sono abilitate per V.23. Se è chiaro, le configurazioni CCITT sono abilitate per V.21 e V.22.

Per impostare V.23, è necessario impostare sia MDM_CCITT_OVERRIDE che MDM_V23_OVERRIDE.

dwMaxDTERate

Frequenza massima di DTE in bit al secondo.

dwMaxDCERate

Frequenza massima del controller di dominio in bit al secondo.

abVariablePortion[1]

Informazioni sulla lunghezza variabile, incluse stringhe e informazioni definite dal provider.

Requisiti

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

Vedi anche

MODEMSETTINGS

Condividi tramite