Compartilhar via


função TSPI_lineSetDefaultMediaDetection (tspi.h)

O procedimento TSPI_lineSetDefaultMediaDetection informa ao provedor de serviços o novo conjunto de tipos de mídia a ser detectado para a linha indicada (substituindo qualquer conjunto anterior). Ele também define o conjunto inicial de tipos de mídia que devem ser monitorados em chamadas subsequentes (entrada ou saída) nessa linha.

Sintaxe

LONG TSPIAPI TSPI_lineSetDefaultMediaDetection(
  HDRVLINE hdLine,
  DWORD    dwMediaModes
);

Parâmetros

hdLine

O identificador para a linha para ter o monitoramento de mídia definido.

dwMediaModes

Os tipos de mídia de interesse para TAPI. Esse parâmetro usa uma 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_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMEDIAMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_NODRIVER LINEERR_OPERATIONUNAVAIL.

Comentários

O TAPI normalmente chama essa função para atualizar o conjunto de tipos de mídia detectados para a linha para a união de todos os modos selecionados por todos os lineOpens pendentes sempre que uma linha é Aberta ou Fechada no nível tapi. Uma tentativa de chamada lineOpen será rejeitada se a detecção de mídia for rejeitada. Uma única chamada para esse procedimento normalmente é o resultado de uma chamada lineOpen que não especifica o identificador de dispositivo LINEMAPPER. O identificador de dispositivo LINEMAPPER nunca é usado no nível do TSPI.

O TAPI deve calcular a união de tipos de mídia desejados por todos os clientes e passar o resultado para essa função. O provedor de serviços usa o conjunto passado para essa função pelo TAPI. O TAPI garante que o parâmetro dwMediaModes tenha pelo menos um bit definido e que nenhum bit reservado esteja 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. A união de todos os tipos de mídia poderá ser o valor 0 se os aplicativos que têm a linha aberta forem todos monitores ou não estiverem interessados em lidar com chamadas de entrada.

Não há nenhuma função diretamente correspondente no nível tapi. Esse procedimento corresponde aos "tipos de mídia de solicitação" implícitos para a linha específica pelo procedimento lineOpen quando ele é chamado com o identificador de dispositivo específico (diferente de LINEMAPPER).

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tspi.h

Confira também

LINECALLPARAMS

Constantes LINEMEDIAMODE_

TSPI_lineClose