função TSPI_lineSetCallParams (tspi.h)

Artigo
03/13/2024

A função TSPI_lineSetCallParams define determinados parâmetros para uma chamada existente.

Sintaxe

LONG TSPIAPI TSPI_lineSetCallParams(
  DRV_REQUESTID          dwRequestID,
  HDRVCALL               hdCall,
  DWORD                  dwBearerMode,
  DWORD                  dwMinRate,
  DWORD                  dwMaxRate,
  LPLINEDIALPARAMS const lpDialParams
);

Parâmetros

dwRequestID

O identificador da solicitação assíncrona.

hdCall

O identificador para a chamada cujos parâmetros devem ser alterados. O estado de chamada pode ser qualquer estado , exceto ocioso e desconectado.

dwBearerMode

O novo modo de portador para a chamada. O parâmetro dwBearerMode pode ter apenas uma das constantes LINEBEARERMODE_.

dwMinRate

Um limite mais baixo para a nova taxa de dados da chamada. O TAPI pode aceitar uma nova taxa tão baixa quanto esta. O TAPI não valida esse parâmetro quando essa função é chamada.

dwMaxRate

Um limite superior para a nova taxa de dados da chamada. Essa é a taxa máxima de dados que a TAPI gostaria. Valores iguais para dwMinRate e dwMaxRate indicam que uma taxa de dados exata é necessária. O TAPI não valida esse parâmetro quando essa função é chamada.

lpDialParams

Um ponteiro para os novos parâmetros de discagem para a chamada, do tipo LINEDIALPARAMS. Se esse parâmetro for NULL, ele indicará que os parâmetros de discagem atuais da chamada devem ser usados.

Retornar valor

Retorna dwRequestID ou um número de erro se ocorrer um erro. O parâmetro real lResult do ASYNC_COMPLETION correspondente será zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:

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

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.