função TSPI_lineSetMediaMode (tspi.h)

Artigo
03/09/2024

A função TSPI_lineSetMediaMode altera a mídia da chamada conforme armazenada na estrutura LINECALLINFO da chamada.

Sintaxe

LONG TSPIAPI TSPI_lineSetMediaMode(
  HDRVCALL hdCall,
  DWORD    dwMediaMode
);

Parâmetros

hdCall

O identificador para a chamada que está passando por uma alteração no tipo de mídia. O estado da chamada de hdCall pode ser qualquer estado.

dwMediaMode

Os novos tipos de mídia para a chamada. Desde que o sinalizador de tipo de mídia LINEMEDIAMODE_UNKNOWN esteja definido, vários outros sinalizadores de tipo de mídia também podem ser definidos. Isso é usado para identificar o tipo de mídia de uma chamada como não totalmente determinado, mas limitado a um de apenas um pequeno conjunto de tipos de mídia especificados. Se o sinalizador LINEMEDIAMODE_UNKNOWN não estiver definido, somente um único tipo de mídia poderá ser especificado. Esse parâmetro usa uma (ou mais) das constantes LINEMEDIAMODE_.

Retornar valor

Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALMEDIAMODE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Comentários

Além de alterar a mídia da chamada como armazenada na estrutura LINECALLINFO da chamada, esse procedimento é simplesmente consultivo no sentido de que indica uma alteração de mídia esperada que está prestes a ocorrer, em vez de forçar uma alteração específica na chamada. O uso típico é definir o tipo de mídia de uma chamada para um tipo de mídia conhecido específico ou excluir possíveis tipos de mídia, desde que o tipo de mídia da chamada não seja totalmente conhecido (o sinalizador de tipo de mídia UNKNOWN está definido).

O TAPI faz as seguintes garantias sobre o tipo de mídia passado: (1) há pelo menos um bit definido, (2) não há nenhum conjunto de bits reservados e (3) se mais de um bit estiver definido, "Desconhecido" também será definido. O provedor de serviços deve executar quaisquer verificações de validade adicionais nos tipos de mídia, como verificar se algum tipo de mídia é realmente compatível com o provedor de serviços.