Estrutura MODEMSETTINGS (mcx.h)
Contém informações sobre a configuração de um modem.
Sintaxe
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;
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.
dwCallSetupFailTimer
O número máximo de segundos que o modem deve aguardar, após a conclusão da discagem, para uma indicação de que uma conexão modem-to-modem foi estabelecida. Se uma conexão não for estabelecida nesse intervalo, supõe-se que a chamada falhou. Este membro é equivalente a registrar S7 em modems compatíveis com Hayes®.
dwInactivityTimeout
O número máximo de segundos de inatividade permitido depois que uma conexão é estabelecida. Se nenhum dado for transmitido ou recebido por esse período de tempo, a chamada será encerrada automaticamente. Esse tempo limite é usado para evitar encargos excessivos de longa distância ou encargos de serviço online se um aplicativo bloqueia inesperadamente ou o usuário sai.
dwSpeakerVolume
O nível de volume do alto-falante do monitor quando o alto-falante está ativado. Esse membro pode ser um dos valores a seguir.
| Valor | Significado |
|---|---|
|
Alto volume. |
|
Volume baixo. |
|
Volume médio. |
A estrutura MODEMDEVCAPS especifica os volumes de alto-falante aos quais um modem dá suporte. Os volumes reais são específicos do hardware.
dwSpeakerMode
O modo de alto-falante. Esse membro pode ser um dos valores a seguir.
dwPreferredModemOptions
As opções de modem solicitadas pelo aplicativo. Os modems locais e remotos negociam opções de modem durante a instalação da chamada; este membro especifica a posição inicial de negociação do modem local.
O membro dwModemOptions da estrutura MODEMDEVCAPS especifica as opções de modem compatíveis com o modem local. Para obter uma lista de opções de modem, consulte a descrição da estrutura MODEMDEVCAPS .
dwNegotiatedModemOptions
As opções de modem que estão realmente em vigor. Esse membro é preenchido depois que uma conexão é estabelecida e os modems locais e remotos negociam opções de modem.
O membro dwModemOptions da estrutura MODEMDEVCAPS especifica as opções de modem compatíveis com o modem local. Para obter uma lista de opções de modem, consulte a descrição da estrutura MODEMDEVCAPS .
dwNegotiatedDCERate
A taxa de DCE em vigor. Esse membro é preenchido depois que uma conexão é estabelecida e os modems locais e remotos negociam modulações de modem.
abVariablePortion[1]
Informações opcionais definidas pelo provedor.
Requisitos
| Cliente mínimo com suporte | Windows XP |
| Servidor mínimo com suporte | Windows Server 2003 |
| Cabeçalho | mcx.h (inclua Windows.h) |