função TSPI_lineSetMediaMode (tspi.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |