Estrutura MODEMDEVCAPS (mcx.h)

Artigo
03/05/2024

Contém informações sobre os recursos de um modem.

Sintaxe

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;

Membros

dwActualSize

O tamanho dos dados realmente retornados para o aplicativo, em bytes. Esse membro poderá ser menor que o membro dwRequiredSize , se um aplicativo não alocar espaço suficiente para a parte de comprimento variável da estrutura.

dwRequiredSize

O número de bytes necessários para toda a estrutura MODEMDEVCAPS , incluindo a parte de comprimento variável.

dwDevSpecificOffset

O deslocamento da parte definida pelo provedor da estrutura, em bytes relativos ao início da estrutura.

dwDevSpecificSize

O tamanho da parte definida pelo provedor da estrutura, em bytes.

dwModemProviderVersion

A versão do provedor de serviços. O formato e o uso desse membro dependem do provedor de serviços.

dwModemManufacturerOffset

O deslocamento de uma cadeia de caracteres de texto que contém o nome do fabricante do modem, em bytes relativos ao início da estrutura.

dwModemManufacturerSize

O comprimento do nome do fabricante do modem, em bytes. A cadeia de caracteres não é terminada em nulo.

dwModemModelOffset

O deslocamento de uma cadeia de caracteres de texto que contém o modelo do modem, em bytes relativos ao início da estrutura.

dwModemModelSize

O comprimento do nome do modelo, em bytes. A cadeia de caracteres não é terminada em nulo.

dwModemVersionOffset

O deslocamento de uma cadeia de caracteres de texto que fornece a versão e a revisão do modem anexado, se o provedor puder determinar as informações. O deslocamento é especificado em bytes relativos ao início da estrutura.

dwModemVersionSize

O comprimento da cadeia de caracteres de versão do modem, em bytes. A cadeia de caracteres não é terminada em nulo.

dwDialOptions

As opções de discagem compatíveis com o dispositivo modem. Esse membro pode ser zero ou mais dos valores a seguir.

Valor	Significado
DIALOPTION_BILLING 0x00000040	O modem dá suporte à espera de tom de cobrança (bong).
DIALOPTION_DIALTONE 0x00000100	O modem dá suporte à espera de um tom de discagem.
DIALOPTION_QUIET 0x00000080	O modem dá suporte à espera de silêncio.

dwCallSetupFailTimer

O tempo limite máximo de configuração de chamada compatível com o modem, em segundos. Esse é o maior valor que pode ser especificado para o membro correspondente da estrutura MODEMSETTINGS .

dwInactivityTimeout

O tempo limite máximo de inatividade suportado pelo modem, em décimos de segundos. Esse é o maior valor que pode ser especificado para o membro correspondente da estrutura MODEMSETTINGS .

dwSpeakerVolume

As configurações de volume do alto-falante compatíveis com o modem. Esse membro pode ser zero ou mais dos valores a seguir.

Valor	Significado
MDMVOLFLAG_HIGH 0x00000004	O modem dá suporte ao volume alto (MDMVOL_HIGH).
MDMVOLFLAG_LOW 0x00000001	O modem dá suporte ao volume baixo (MDMVOL_LOW).
MDMVOLFLAG_MEDIUM 0x00000002	O modem dá suporte ao volume médio (MDMVOL_MEDIUM).

dwSpeakerMode

As configurações do modo de alto-falante compatíveis com o modem. Esse membro pode ser zero ou mais dos valores a seguir.

Valor	Significado
MDMSPKRFLAG_CALLSETUP 0x00000008	O modem dá suporte ao modo de alto-falante MDMSPKR_CALLSETUP.
MDMSPKRFLAG_DIAL 0x00000002	O modem dá suporte ao modo de alto-falante MDMSPKR_DIAL.
MDMSPKRFLAG_OFF 0x00000001	O modem dá suporte ao modo de alto-falante MDMSPKR_OFF.
MDMSPKRFLAG_ON 0x00000004	O modem dá suporte ao modo de alto-falante MDMSPKR_ON.

dwModemOptions

As opções de modem. Esse membro pode ser zero ou mais dos valores a seguir.

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 é usado para definir opções de modem, como parte da estrutura MODEMSETTINGS , esses valores são usados da seguinte maneira.

Valor	Significado
MDM_CCITT_OVERRIDE 0x00000040	Quando definidas, as modulações CCITT são habilitadas para V.21 e V.22 ou V.23. Quando claro, as modulações de sino são habilitadas para 103 e 212A.
MDM_V23_OVERRIDE 0x00000400	Quando definidas, as modulações CCITT são habilitadas para v.23. Quando claro, as modulações CCITT são habilitadas para V.21 e V.22.

Para que a V.23 seja definida, MDM_CCITT_OVERRIDE e MDM_V23_OVERRIDE devem ser definidos.

dwMaxDTERate

A taxa de DTE máxima em bits por segundo.

dwMaxDCERate

A taxa de DCE máxima em bits por segundo.

abVariablePortion[1]

Informações de comprimento variável, incluindo cadeias de caracteres e quaisquer informações definidas pelo provedor.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP
Servidor mínimo com suporte	Windows Server 2003
Cabeçalho	mcx.h (inclua Windows.h)

Confira também

MODEMSETTINGS

Compartilhar via