LINEDEVCAPS

Artigo
09/19/2008

Windows Mobile Supported Windows Embedded CE Supported

9/19/2008

Essa estrutura descreve os recursos de um dispositivo de linha.

Syntax

typedef struct linedevcaps_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwProviderInfoSize;
  DWORD dwProviderInfoOffset;
  DWORD dwSwitchInfoSize;
  DWORD dwSwitchInfoOffset;
  DWORD dwPermanentLineID;
  DWORD dwLineNameSize;
  DWORD dwLineNameOffset;
  DWORD dwStringFormat; 
  DWORD dwAddressModes;
  DWORD dwNumAddresses;
  DWORD dwBearerModes;
  DWORD dwMaxRate;
  DWORD dwMediaModes;
  DWORD dwGenerateToneModes;
  DWORD dwGenerateToneMaxNumFreq;
  DWORD dwGenerateDigitModes;
  DWORD dwMonitorToneMaxNumFreq;
  DWORD dwMonitorToneMaxNumEntries;
  DWORD dwMonitorDigitModes;
  DWORD dwGatherDigitsMinTimeout;
  DWORD dwGatherDigitsMaxTimeout;
  DWORD dwMedCtlDigitMaxListSize;
  DWORD dwMedCtlMediaMaxListSize;
  DWORD dwMedCtlToneMaxListSize;
  DWORD dwMedCtlCallStateMaxListSize;
  DWORD dwDevCapFlags;
  DWORD dwMaxNumActiveCalls;
  DWORD dwAnswerMode;
  DWORD dwRingModes;
  DWORD dwLineStates;
  DWORD dwUUIAcceptSize;
  DWORD dwUUIAnswerSize;
  DWORD dwUUIMakeCallSize;
  DWORD dwUUIDropSize;
  DWORD dwUUISendUserUserInfoSize;
  DWORD dwUUICallInfoSize;
  LINEDIALPARAMS MinDialParams;
  LINEDIALPARAMS MaxDialParams;
  LINEDIALPARAMS DefaultDialParams;
  DWORD dwNumTerminals;
  DWORD dwTerminalCapsSize;
  DWORD dwTerminalCapsOffset;
  DWORD dwTerminalTextEntrySize;
  DWORD dwTerminalTextSize;
  DWORD dwTerminalTextOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset
  DWORD dwLineFeatures;
  DWORD dwSettableDevStatus;
  DWORD dwDeviceClassesSize;
  DWORD dwDeviceClassesOffset;
} LINEDEVCAPS, Far* LPLINEDEVCAPS;

Os membros

dwTotalSize
Tamanho total, em bytes, alocadas para este estrutura de dados.

dwNeededSize
Tamanho, em bytes, para este estrutura de dados que é necessário para manter todos os dados retornados.

dwUsedSize
Tamanho, em bytes, da parte desta estrutura de dados que contém dados úteis.

dwProviderInfoSize
Tamanho, em bytes, do campo que contém dados provedor serviço.

dwProviderInfoOffset
Deslocamento, em bytes, do início deste estrutura de dados.

O dwProviderInfoSize e dwProviderInfoOffset Os membros têm o objetivo de fornecer dados sobre o hardware provedor e / ou software, such as o fornecedor Nome e versão números de hardware e software. Este dados podem ser útil quando um usuário precisa chamar serviço cliente com problemas sobre o provedor.

dwSwitchInfoSize
Tamanho, em bytes, do campo de variably tamanho dispositivo que contém dados alternar.

dwSwitchInfoOffset
Deslocamento, em bytes, do início deste estrutura de dados.

O dwSwitchInfoSizeedwProviderInfoOffset Os membros têm o objetivo de fornecer dados sobre a alternar para que o dispositivo de linha está conectado, such as o fabricante alternar, nome de modelo, o software versão e SO on. Este dados podem ser útil quando um usuário precisa chamar serviço cliente com problemas em relação a alternar.

dwPermanentLineID
Sem suporte; definido como zero.

dwLineNameSize
Tamanho, em bytes, do campo variably tamanho dispositivo que contém um configurável usuário nome para este dispositivo de linha.

dwLineNameOffset
Deslocamento, em bytes, do início deste estrutura de dados. Esse nome pode ser configurado pelo usuário ao configurar provedor serviço do dispositivo de linha e é fornecido por conveniência do usuário a.

dwStringFormat
Valor que especifica o formato da seqüência de caracteres usado com este dispositivo de linha. Usa este membro STRINGFORMAT.

dwAddressModes
Valor que especifica o modo pelo qual o endereço de origem for especificado. Usa este membro a LINEADDRESSMODE.

dwNumAddresses
Número de endereços associado com este dispositivo de linha. Endereços individuais são chamados por endereço identificadores. Intervalo de zero para uma menor do que o valor indicado por identificadores endereço dwNumAddresses.

dwBearerModes
Matriz sinalizador que indica os modos de transmissão diferentes que o endereço é capaz suporte. Usa este membro LINEBEARERMODE.

dwMaxRate
Taxa máxima dados em bits por segundo para a troca dados sobre o chamar.

dwMediaModes
Matriz sinalizador que indica os modos de mídia diferente de endereço é capaz suporte. Usa este membro LINEMEDIAMODE.

dwGenerateToneModes
Sem suporte; definido como zero.

dwGenerateToneMaxNumFreq
Sem suporte; definido como zero.

dwGenerateDigitModes
Sem suporte; definido como zero.

dwMonitorToneMaxNumFreq
Sem suporte; definido como zero.

dwMonitorToneMaxNumEntries
Sem suporte; definido como zero.

dwMonitorDigitModes
Sem suporte; definido como zero.

dwGatherDigitsMinTimeout
Sem suporte; definido como zero.

dwGatherDigitsMaxTimeout
Sem suporte; definido como zero.

dwMedCtlDigitMaxListSize
Sem suporte; definido como zero.

dwMedCtlMediaMaxListSize
Número máximo de entradas que podem ser especificadas na lista de mídia.

dwMedCtlToneMaxListSize
Sem suporte; definido como zero.

dwMedCtlCallStateMaxListSize
Número máximo de entradas que podem ser especificadas no estado de chamar lista.

dwDevCapFlags
Valor que especifica vários Boolean recursos dispositivo. Usa este membro LINEDEVCAPFLAGS.

dwMaxNumActiveCalls
Número máximo de chamadas (largura de banda mínimo) que podem ser ativo (conectado) na linha em qualquer um tempo. O real número do ativo chamadas podem ser menor se chamadas largura de banda superiores foram estabelecidas na linha.

dwAnswerMode
Valor que especifica o efeito sobre o ativo chamar quando responder chamar outro oferta em um dispositivo de linha. Usa este membro LINEANSWERMODE.

dwRingModes
Número de modos de toque diferentes que podem ser relatados na LINE_LINEDEVSTATE mensagem com o tocando indicação. Intervalo modos toque diferente de uma para dwRingModes. Zero Não indica nenhum anel.

dwLineStates
Especifica os componentes status de linha diferente para o qual o aplicativo pode ser notificado em uma mensagem LINE_LINEDEVSTATE nesta linha. Usa este membro LINEDEVSTATE.

dwUUIAcceptSize
Tamanho máximo do usuário-usuário dados que podem ser enviados durante um aceitar chamar.

dwUUIAnswerSize
Tamanho máximo do usuário-usuário dados que podem ser enviados durante uma resposta chamar.

dwUUIMakeCallSize
Tamanho máximo do usuário-usuário dados que podem ser enviados durante um tornar chamar.

dwUUIDropSize
Tamanho máximo do usuário-usuário dados que podem ser enviados durante um ato de soltar chamar.

dwUUISendUserUserInfoSize
Sem suporte; definido como zero.

dwUUICallInfoSize
Tamanho máximo do usuário-usuário dados que podem ser recebidos na LINECALLINFO estrutura.

MinDialParams
Sem suporte; definido como zero.

MaxDialParams
Sem suporte; definido como zero.

DefaultDialParams
Sem suporte; definido como zero.

dwNumTerminals
Sem suporte; definido como zero.

dwTerminalCapsSize
Sem suporte; definido como zero.

dwTerminalCapsOffset
Sem suporte; definido como zero.

dwTerminalTextEntrySize
Sem suporte; definido como zero.

dwTerminalTextSize
Sem suporte; definido como zero.

dwTerminalTextOffset
Sem suporte; definido como zero.

dwDevSpecificSize
Tamanho, em bytes, do campo Device-specific variably tamanho.

dwDevSpecificOffset
Deslocamento, em bytes, do início deste estrutura de dados.

dwLineFeatures
Valor que especifica o disponível recursos para usar esta linha de LINEFEATURE. Chamar um com suporte recurso requer a linha para estar no estado adequado e o subjacente linha dispositivo a ser aberto em um compatível modo. Um zero em uma posição bit indica que o correspondente recurso nunca está disponível. Um indica que o correspondente recurso pode estar disponível se a linha for no apropriado estado para a operação seja significativo. Este membro permite que um aplicativo para descobrir quais recursos de linha podem ser, e que nunca pode ser, com suporte, o dispositivo.

dwSettableDevStatus
LINEDEVSTATUSFLAGS que pode ser modificado.

dwDeviceClassesSize
Comprimento em bytes do início do LINEDEVCAPS de uma seqüência de caracteres consistindo de identificadores de classe dispositivo com suporte em um ou mais endereços nesta linha para uso com o lineGetID função, separada por NULL caracteres; o último identificador na lista é seguido por dois NULL caracteres.

dwDeviceClassesOffset
Deslocamento do seqüência de caracteres descrito na dwDeviceClassesSize membro.

Remarks

Extensões específicas do dispositivo devem usar o dwDevSpecificSize e dwDevSpecificOffset membros dessa estrutura.

Os aplicativos mais antigos são compilado sem os novos membros a LINEDEVCAPS estrutura e usando um LINEDEVCAPS SIZEOF menor que o novo tamanho. O aplicativo passa em um dwAPIVersion parâmetro com o lineGetDevCaps função, que pode ser usada para orientação por TAPI na manipulação nessa situação. Se o aplicativo passa em um dwTotalSize membro menor do que o tamanho da parte fixa da estrutura conforme definido na especificado dwAPIVersionLINEERR_STRUCTURETOOSMALL, será retornado. Se foi alocada memória suficiente, o aplicativo, antes chamado TSPI_lineGetDevCaps, TAPI define o dwNeededSize e dwUsedSize Os membros de tamanho fixo da estrutura como ele existiam na versão API especificado.

Novos aplicativos devem ser conhecedora da versão API negociado e não examine o conteúdo de membros a parte fixa além de original final da parte fixa da estrutura para a versão API negociado.

Se o bit LINEBEARERMODE_DATA estiver definida na dwBearerModes membro, o dwMaxRate membro indica a taxa máxima de digital transmissão em canalizar a transmissão. O dwMaxRate membro das LINEDEVCAPS estrutura pode conter válido valores mesmo se a dwBearerModes membro das LINEDEVCAPS estrutura não está definida para LINEBEARERMODE_DATA.

Se LINEBEARERMODE_DATA não é definida no dwBearerModes, mas o valor LINEBEARERMODE_VOICE é definida e o valor LINEMEDIAMODE_DATAMODEM é definido na dwMediaModes membro, o dwMaxRate membro indica o máximo de taxa de bits SYNCHRONOUS (DCE) na linha de telefone para o anexado modem ou equivalente funcional. De exemplo, se o modem é mais rápida de modulação velocidade é V.32bis em 14, 400bps, dwMaxRate é igual a 14400. Este é Não a taxa porta DTE mais rápida (que provavelmente poderia ser 38400, 57600 ou 115200), mas o mais rápido taxa de bits o modem oferece suporte a na linha telefônica.

O aplicativo deve cuidado para verificar se está LINEBEARERMODE_DATA Não Conjunto, para evitar misinterpreting o dwMaxRate membro. Ele provavelmente será 64000 ou superior se LINEBEARERMODE_DATA for definida.

Ele também deve ser observado que se tem o modem não foi especificamente identificado (por exemplo, é um genérico modem), o definir indicada uma melhor estimativa baseia-se no exame do modem.

Requirements

Header	tapi.h
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

Compartilhar via

LINEDEVCAPS

Syntax

Os membros

Remarks

Requirements

See Also

Reference

Recursos adicionais