Função lineSetCallParams (tapi.h)

Artigo
08/26/2023

A função lineSetCallParams permite que um aplicativo altere o modo de portador e/ou os parâmetros de taxa de uma chamada existente.

Sintaxe

LONG lineSetCallParams(
  HCALL                  hCall,
  DWORD                  dwBearerMode,
  DWORD                  dwMinRate,
  DWORD                  dwMaxRate,
  LPLINEDIALPARAMS const lpDialParams
);

Parâmetros

hCall

Manipule para a chamada cujos parâmetros devem ser alterados. O aplicativo deve ser um proprietário da chamada. O estado de chamada de hCall pode ser qualquer estado , exceto ocioso ou desconectado.

dwBearerMode

Novo modo de portador para a chamada. Esse parâmetro usa uma e apenas uma das Constantes LINEBEARERMODE_.

dwMinRate

Limite mais baixo para a nova taxa de dados da chamada. O aplicativo pode aceitar uma nova taxa tão baixa quanto esta.

dwMaxRate

Limite superior para a nova taxa de dados da chamada. Essa é a taxa máxima de dados que o aplicativo pode aceitar. Se uma taxa de dados exata for necessária, dwMinRate e dwMaxRate deverão ser iguais.

lpDialParams

Ponteiro para os novos parâmetros de discagem para a chamada, do tipo LINEDIALPARAMS. Esse parâmetro poderá ser deixado NULL se os parâmetros de discagem atuais da chamada forem usados.

Retornar valor

Retorna um identificador de solicitação positivo se a função for concluída de forma assíncrona ou um número de erro negativo se ocorrer um erro. O parâmetro dwParam2 da mensagem de LINE_REPLY correspondente será zero se a função for bem-sucedida ou se for um número de erro negativo se ocorrer um erro. Os possíveis valores retornados são:

LINEERR_BEARERMODEUNAVAIL, LINEERR_NOTOWNER, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RATEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALRATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Comentários

Essa operação é usada para alterar os parâmetros de uma chamada existente. Exemplos de seu uso incluem alterar o modo de portador e/ou a taxa de dados de uma chamada existente.