Função lineSetMediaMode (tapi.h)

Artigo
08/26/2023

A função lineSetMediaMode define os tipos de mídia da chamada especificada em sua estrutura LINECALLINFO . Para obter mais informações, consulte ITLegacyCallMediaControl::SetMediaType.

Sintaxe

LONG lineSetMediaMode(
  HCALL hCall,
  DWORD dwMediaModes
);

Parâmetros

hCall

Manipule para a chamada cujo tipo de mídia deve ser alterado. O aplicativo deve ser um proprietário da chamada. O estado de chamada de hCall pode ser qualquer estado.

dwMediaModes

Novos tipos de mídia para a chamada. Esse parâmetro usa as constantes LINEMEDIAMODE_. Enquanto o sinalizador de tipo de mídia UNKNOWN estiver definido, outros sinalizadores de tipo de mídia também poderão ser definidos. Isso é usado para identificar o tipo de mídia de uma chamada como não totalmente determinado, mas limitado a um de um pequeno conjunto de tipos de mídia especificados. Se o sinalizador UNKNOWN não estiver definido, somente um único tipo de mídia poderá ser especificado.

Valor retornado

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

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

Comentários

A função lineSetMediaMode altera o tipo de mídia da chamada em sua estrutura LINECALLINFO . O uso típico dessa operação é 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 seja oficialmente desconhecido (o sinalizador de tipo de mídia UNKNOWN está definido).