funzione TSPI_lineSetDefaultMediaDetection (tspi.h)

Articolo
03/03/2024

La procedura TSPI_lineSetDefaultMediaDetection indica al provider di servizi il nuovo set di tipi di supporti da rilevare per la riga indicata (sostituendo qualsiasi set precedente). Imposta anche il set iniziale di tipi di supporti che devono essere monitorati per le chiamate successive (in ingresso o in uscita) su questa riga.

Sintassi

LONG TSPIAPI TSPI_lineSetDefaultMediaDetection(
  HDRVLINE hdLine,
  DWORD    dwMediaModes
);

Parametri

hdLine

Handle della riga in cui è impostato il monitoraggio multimediale.

dwMediaModes

Tipi di supporti di interesse per TAPI. Questo parametro usa una 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_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMEDIAMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_NODRIVER LINEERR_OPERATIONUNAVAIL.

Commenti

TAPI chiama in genere questa funzione per aggiornare il set di tipi di supporti rilevati per la linea all'unione di tutte le modalità selezionate da tutte le modalità in sospesoOpens ogni volta che una riga viene aperta o chiusa a livello TAPI. Un tentativo di chiamata lineOpen viene rifiutato se il rilevamento dei supporti viene rifiutato. Una singola chiamata a questa procedura è in genere il risultato di una chiamata lineOpen che non specifica l'identificatore del dispositivo LINEMAPPER. L'identificatore del dispositivo LINEMAPPER non viene mai usato a livello TSPI.

TAPI deve calcolare l'unione dei tipi di supporti desiderati da tutti i client e passare il risultato a questa funzione. Il provider di servizi usa il set passato a questa funzione da TAPI. TAPI garantisce che il parametro dwMediaModes abbia almeno un bit impostato e che non siano impostati bit riservati. Il provider di servizi deve eseguire ulteriori controlli di validità sui tipi di supporti, ad esempio per verificare se i tipi di supporti sono effettivamente supportati dal provider di servizi. L'unione di tutti i tipi di supporti può essere il valore 0 se le applicazioni con apertura linea sono tutti monitoraggi o non interessati alla gestione delle chiamate in ingresso.

Non esiste alcuna funzione direttamente corrispondente a livello TAPI. Questa procedura corrisponde ai "tipi di supporti di richiesta" impliciti per la riga specifica dalla routine lineOpen quando viene chiamata con l'identificatore di dispositivo specifico (diverso da LINEMAPPER).