funzione TSPI_lineSetMediaMode (tspi.h)

La funzione TSPI_lineSetMediaMode modifica il supporto della chiamata come archiviato nella struttura LINECALLINFO della chiamata.

Sintassi

LONG TSPIAPI TSPI_lineSetMediaMode(
  HDRVCALL hdCall,
  DWORD    dwMediaMode
);

Parametri

hdCall

Handle per la chiamata che subisce una modifica del tipo di supporto. Lo stato della chiamata di hdCall può essere qualsiasi stato.

dwMediaMode

Nuovo tipo di supporto per la chiamata. Purché sia impostato il flag del tipo di supporto LINEMEDIAMODE_UNKNOWN, è possibile impostare anche più flag di tipo multimediale. Questa operazione viene usata per identificare il tipo di supporto di una chiamata come non completamente determinato, ma limitato a un piccolo set di tipi di supporti specificati. Se il flag LINEMEDIAMODE_UNKNOWN non è impostato, è possibile specificare solo un singolo tipo di supporto. Questo parametro usa una (o più) delle costanti LINEMEDIAMODE_.

Valore restituito

Restituisce zero se la funzione ha esito positivo o un numero di errore se si verifica un errore. I valori restituiti possibili sono i seguenti:

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

Commenti

Oltre a modificare i supporti della chiamata come archiviati nella struttura LINECALLINFO della chiamata, questa procedura è semplicemente consultiva nel senso che indica un cambiamento multimediale previsto che sta per verificarsi, anziché forzare una modifica specifica alla chiamata. L'utilizzo tipico consiste nell'impostare il tipo di supporto di una chiamata a un tipo di supporto noto specifico oppure per escludere i tipi di supporti possibili, purché il tipo di supporto della chiamata non sia completamente noto (il flag del tipo di supporto UNKNOWN è impostato).

TAPI garantisce le garanzie seguenti relative al tipo di supporto passato: (1) è presente almeno un set di bit, (2) non sono presenti bit riservati e (3) se è impostato più di un bit, viene impostato anche "Sconosciuto". Il provider di servizi deve eseguire ulteriori controlli di validità sui tipi di supporti, ad esempio verificare se qualsiasi tipo di supporto è effettivamente supportato dal provider di servizi.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	tspi.h

Vedi anche

LINECALLINFO

costanti LINEMEDIAMODE_

TSPI_lineGetCallInfo