LINECALLPARAMS
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/19/2008
Essa estrutura descreve parâmetros fornecidos ao fazer chamadas usando o lineMakeCall função. O LINECALLPARAMS estrutura também é usada como um parâmetro em outras operações.
Syntax
typedef struct linecallparams_tag {
DWORD dwTotalSize;
DWORD dwBearerMode;
DWORD dwMinRate;
DWORD dwMaxRate;
DWORD dwMediaMode;
DWORD dwCallParamFlags;
DWORD dwAddressMode;
DWORD dwAddressID;
LINEDIALPARAMS DialParams;
DWORD dwOrigAddressSize;
DWORD dwOrigAddressOffset;
DWORD dwDisplayableAddressSize;
DWORD dwDisplayableAddressOffset;
DWORD dwCalledPartySize;
DWORD dwCalledPartyOffset;
DWORD dwCommentSize;
DWORD dwCommentOffset;
DWORD dwUserUserInfoSize;
DWORD dwUserUserInfoOffset;
DWORD dwHighLevelCompSize;
DWORD dwHighLevelCompOffset;
DWORD dwLowLevelCompSize;
DWORD dwLowLevelCompOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwPredictiveAutoTransferStates;
DWORD dwTargetAddressSize;
DWORD dwTargetAddressOffset;
DWORD dwSendingFlowspecSize;
DWORD dwSendingFlowspecOffset;
DWORD dwReceivingFlowspecSize;
DWORD dwReceivingFlowspecOffset;
DWORD dwDeviceClassSize;
DWORD dwDeviceClassOffset;
DWORD dwDeviceConfigSize;
DWORD dwDeviceConfigOffset;
DWORD dwCallDataSize;
DWORD dwCallDataOffset;
DWORD dwNoAnswerTimeout;
DWORD dwCallingPartyIDSize;
DWORD dwCallingPartyIDOffset;
DWORD dwAddressType;
} LINECALLPARAMS, FAR* LPLINECALLPARAMS;
Os membros
- dwTotalSize
Tamanho total, em bytes, alocadas para este estrutura de dados. Esse tamanho deve ser grande o suficiente para armazenar todas as partes de fixas e variably tamanhos deste estrutura de dados.
dwBearerMode
Valor que especifica o modo de transmissão para o chamar. Se dwBearerMode é definido como qualquer valor exceto LINEBEARERMODE_PASSTHROUGH, o chamar tentará completo se ou não esse modo de transmissão é com suporte na linha que está sendo acessada. Usa este membro LINEBEARERMODE.Se dwBearerMode for zero, o valor usar como padrão é LINEBEARERMODE_VOICE.
- dwMinRatee dwMaxRate
Valor que especifica que os dados Taxa intervalo solicitado para fluxo de dados do chamar em bps (bits por segundo). Ao fazer uma chamar, provedor de serviço tenta fornecer o mais alto disponível taxa no intervalo solicitado. Se for uma taxa específica dados exigido, o Min e Max devem ser definidos para esse valor. Se um aplicativo funciona melhor com uma taxa, mas poderá degradar para taxas inferiores, o aplicativo deve especificar esses como as taxas máxima e mínimas, respectivamente. Se dwMaxRate for zero, o valor usar como padrão é especificado pelo dwMaxRate membro das LINEDEVCAPS estrutura. Esta é a taxa máxima com suporte, o dispositivo.
- dwMediaMode
Valor que especifica o modo de mídia esperado do chamar. Usa este membro LINEMEDIAMODE. Se dwMediaMode for zero, o valor usar como padrão é LINEMEDIAMODE_INTERACTIVEVOICE.
- dwCallParamFlags
Valor que especifica uma coleção de Boolean chamar-parâmetros instalação. Usa este membro LINECALLPARAMFLAGS.
- dwAddressMode
Valor que especifica o modo pelo qual o endereço de origem for especificado. O dwAddressMode membro não pode ser LINEADDRESSMODE_ADDRESSID para a lineOpen chamada de função. Usa este membro LINEADDRESSMODE.
- dwAddressID
Endereço identificador de endereço de origem se dwAddressMode é definido como LINEADDRESSMODE_ADDRESSID.
- DialParams
Sem suporte; definido como zero.
- dwOrigAddressSize
Tamanho, em bytes, do campo que contém o endereço de origem.
- dwOrigAddressOffset
Deslocamento, em bytes, do início deste estrutura de dados. O formato desse endereço é dependente na dwAddressMode membro.
- dwDisplayableAddressSize
Especifica o que é usado para fins log seqüência de caracteres exibível. O de conteúdo de seqüência de caracteres thi é registrado na dwDisplayableAddressOffset e dwDisplayableAddressSize Os membros da chamar LINE_CALLINFO mensagem. O lineTranslateAddress função retorna apropriado dados sejam colocados neste campo na dwDisplayableAddressSize membro das LINETRANSLATEOUTPUT estrutura.
- dwDisplayableAddressOffset
Especifica o que é usado para fins log seqüência de caracteres exibível. O de conteúdo de seqüência de caracteres thi é registrado na dwDisplayableAddressOffset e dwDisplayableAddressSize Membros de mensagem LINE_CALLINFO da chamar. O lineTranslateAddress função retorna apropriado dados sejam colocados neste campo na dwDisplayableAddressOffset membro das LINETRANSLATEOUTPUT estrutura.
- dwCalledPartySize
Tamanho, em bytes, do campo que armazena chamado-parte dados.
- dwCalledPartyOffset
Deslocamento, em bytes, do início deste estrutura de dados. Este dados podem ser especificados pelo aplicativo que faz a chamar e fica disponível em estrutura de dados da chamar para fins log. O formato deste campo é de dwStringFormat, conforme especificado em LINEDEVCAPS.
- dwCommentSize
Tamanho, em bytes, do campo que contém comentários sobre o chamar.
- dwCommentOffset
Deslocamento, em bytes, do início deste estrutura de dados. Este dados podem ser especificados pelo aplicativo que faz a chamar e fica disponível em estrutura de dados da chamar para fins log. O formato deste campo é de dwStringFormat, conforme especificado em LINEDEVCAPS.
- dwUserUserInfoSize
Tamanho, em bytes, do campo que contém usuário-usuário dados.
- dwUserUserInfoOffset
Deslocamento, em bytes, do início deste estrutura de dados. O campo discriminador protocolo para o usuário-usuário dados, se exigido, deve aparecer como o primeiro byte de dados apontados pelo dwUserUserInfoOffsete deve ser contabilizada na dwUserUserInfoSize.
- dwHighLevelCompSize
Tamanho, em bytes, do campo que armazena dados de alto nível compatibilidade.
- dwHighLevelCompOffset
Deslocamento, em bytes, do início deste estrutura de dados.
- dwLowLevelCompSize
Tamanho, em bytes, do campo que armazena dados de nível inferior compatibilidade.
- dwLowLevelCompOffset
Deslocamento, em bytes, do início deste estrutura de dados.
- dwDevSpecificSize
Tamanho, em bytes, do campo que armazena dados Device-specific.
- dwDevSpecificOffset
Deslocamento, em bytes, do início deste estrutura de dados.
- dwPredictiveAutoTransferStates
O LINECALLSTATE_ valores, entrada em que causar a chamar seja Blind-transferred para endereço de destino especificado. Definido como zero se transferir automática não for desejada.
- dwTargetAddressSize
Tamanho, em bytes, de uma seqüência de caracteres especificando o endereço destino que possa ser discado — não dwAddressID. Usado na maiúsculas e minúsculas de determinadas ações automáticas. Na maiúsculas e minúsculas de discagem de previsão, especifica o endereço ao qual a chamar deve ser automaticamente transferidos. Definido como zero se transferir automática não for desejada. Na maiúsculas e minúsculas de um No Hold Conference, especifica o endereço que deve ser adicionado para a chamar. Na maiúsculas e minúsculas de um One Step Transfer, especifica o endereço para discagem na chamar auxílio.
- dwTargetAddressOffset
Offset do início do LINECALLPARAMS de uma seqüência de caracteres especificando o endereço discável destino — não dwAddressID. Usado na maiúsculas e minúsculas de determinadas ações automáticas. Na maiúsculas e minúsculas de discagem de previsão, especifica o endereço ao qual a chamar deve ser automaticamente transferidos. Definido como zero se transferir automática não for desejada. Na maiúsculas e minúsculas de um No Hold Conference, especifica o endereço que deve ser adicionado para a chamar. Na maiúsculas e minúsculas de um One Step Transfer, especifica o endereço para discagem na chamar auxílio.
- dwSendingFlowspecSize
Tamanho total, em bytes, de uma Winsock2 FLOWSPEC estrutura seguida dados Provider-specific Winsock2.
- dwSendingFlowspecOffset
Offset do início do LINECALLPARAMS De uma Winsock2 FLOWSPEC estrutura seguida dados Provider-specific Winsock2. A seguinte parte Provider-specific o FLOWSPEC estrutura não deve conter ponteiros para outros blocos de memória, como TAPI não sabe como empacotar os dados apontado pelos ponteiros particulares e transmitem-la por meio entre processos a comunicação com o aplicativo.
- dwReceivingFlowspecSize
Tamanho total, em bytes, de uma Winsock2 FLOWSPEC estrutura.
- dwReceivingFlowspecOffset
Offset do início do LINECALLPARAMS De uma Winsock2 FLOWSPEC estrutura. A seguinte parte Provider-specific o FLOWSPEC estrutura não deve conter ponteiros para outros blocos de memória, como TAPI não sabe como empacotar os dados apontado pelos ponteiros particulares e transmitem-la por meio entre processos a comunicação com o aplicativo.
- dwDeviceClassSize
Tamanho, em bytes, de uma seqüência de caracteres ASCII NULL-Terminated (o tamanho inclui o NULL) que indica a classe dispositivo do dispositivo cuja configuração é especificada na DeviceConfig. Dispositivo válido classe seqüências são os mesmos que aqueles especificados para o lineGetID função.
- dwDeviceClassOffset
Offset do início do LINECALLPARAMS de uma seqüência de caracteres ASCII NULL-Terminated (o tamanho inclui o NULL) que indica a classe dispositivo do dispositivo cuja configuração é especificada na DeviceConfig.
- dwDeviceConfigSize
Tamanho, em bytes, da opacidade configuração estrutura de dados apontado pelo dwDevConfigOffset. Esse valor é retornado na dwStringSize membro in a VARSTRING estrutura retornada por lineGetDevConfig. Se o tamanho for zero, a configuração dispositivo usar como padrão será usada. Isso permite que o aplicativo para definir a configuração dispositivo antes de chamar é iniciada.
- dwDeviceConfigOffset
Offset do início do LINECALLPARAMS Da opacidade configuração estrutura de dados apontado pelo dwDevConfigOffset.
- dwCallDataSize
Tamanho, em bytes, dos dados chamar Application-Settable ser inicialmente anexado para o chamar.
- dwCallDataOffset
Offset do início do LINECALLPARAMS dos dados chamar Application-Settable ser inicialmente anexado para o chamar.
- dwNoAnswerTimeout
Número de segundos, após a conclusão de discagem, que o chamar deve esperar no estado de PROCEEDING ou RINGBACK, antes de abandonado pelo provedor de serviço com um LINECALLSTATE_DISCONNECTED e LINEDISCONNECTMODE_NOANSWER. Um valor de zero indica que o aplicativo não desejar chamar automática abandonment.
- dwCallingPartyIDSize
Tamanho, em bytes, de uma seqüência de caracteres ASCII NULL-Terminated (o tamanho inclui o NULL) que especifica a identidade da parte colocando o chamar.
- dwCallingPartyIDOffset
Offset do início do LINECALLPARAMS de uma seqüência de caracteres ASCII NULL-Terminated (o tamanho inclui o NULL) que especifica a identidade da parte colocando o chamar. Se o de conteúdo do identificador é aceitável e é um caminho disponível, o provedor serviço passa o identificador ao longo para o chamado parte para indicar a identidade da parte chamado.
- dwAddressType
Endereço tipo usado para a chamar. Esse membro é disponível somente se a versão TAPI negociado for 3.0 ou posterior.
Remarks
Extensões específicas do dispositivo devem usar o dwDevSpecificSize e dwDevSpecificOffset membros dessa estrutura.
Essa estrutura é usada como um parâmetro para o lineMakeCall função quando configuração até um chamar. Habilitar seu campos de aplicativo para especificar uma variedade de chamar ISDN-parâmetros instalação. Se nenhum LINECALLPARAMS estrutura é fornecida para lineMakeCall, um chamar Voice-grade usar como padrão POTS é solicitado com os valores usar como padrão listados acima.
Observação
Os membros dwOrigAddressSize Por meio dwDevSpecificOffset são ignorados quando um lpCallParams parâmetro for especificado com o lineOpen função.
Para Windows CE 1.0 através de 2.12, a seguinte membros não são com suporte:
- dwUUISendUserUserInfoSize
- dwDeviceClassSize
- dwMinRate
- dwDeviceClassOffset
- dwMaxRate
- dwDeviceConfigSize
- dwPredictiveAutoTransferStates
- dwDeviceConfigOffset
- dwTargetAddressSize
- dwCallDataSize
- dwTargetAddressOffset
- dwCallDataOffset
- dwSendingFlowspecSize
- dwNoAnswerTimeout
- dwSendingFlowspecOffset
- dwCallingPartyIDSize
- dwReceivingFlowspecSize
- dwCallingPartyIDOffset
- dwReceivingFlowspecOffset
Requirements
| Header | tapi.h |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
lineMakeCall
lineOpen
lineGetID
lineGetDevConfig
lineTranslateAddress
LINEDEVCAPS
LINETRANSLATEOUTPUT
VARSTRING