funzione TSPI_lineSetStatusMessages (tspi.h)

Articolo
03/13/2024

La funzione TSPI_lineSetStatusMessages consente a TAPI di specificare i messaggi di notifica che il provider di servizi deve generare per gli eventi correlati alle modifiche di stato per la riga specificata o uno dei relativi indirizzi.

Sintassi

LONG TSPIAPI TSPI_lineSetStatusMessages(
  HDRVLINE hdLine,
  DWORD    dwLineStates,
  DWORD    dwAddressStates
);

Parametri

hdLine

Handle per il dispositivo linea per il quale deve essere impostato il nuovo filtro.

dwLineStates

Matrice di bit che identifica per quale stato del dispositivo della riga cambia un messaggio da inviare a TAPI. Questo parametro usa una delle costanti LINEDEVSTATE_.

dwAddressStates

Matrice di bit che identifica per quale stato dell'indirizzo cambia un messaggio da inviare a TAPI. Questo parametro usa una delle costanti LINEADDRESSSTATE_.

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_INVALADDRESSSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINESTATE, LINEERR_RESOURCEUNAVAIL LINEERR_NOMEM.

Commenti

Il provider di servizi restituisce LINEERR_INVALLINESTATE se il parametro dwLineStates contiene uno o più bit che non sono costanti LINEDEVSTATE_.

La telefonia definisce un numero di messaggi che notificano alle applicazioni gli eventi che si verificano su righe e indirizzi. I set di tutti i messaggi di modifica in cui tutte le applicazioni sono interessate possono essere molto più piccoli del set di messaggi possibili. Questa procedura consente a TAPI di indicare al provider di servizi il set ridotto di messaggi da recapitare. Il provider di servizi recapita tutti i messaggi supportati, all'interno del set specificato. È consentito offrire di più (vengono filtrati in base a TAPI), ma è sconsigliato farlo per motivi di prestazioni. Se TAPI richiede il recapito di un determinato tipo di messaggio non prodotto dal provider, il provider accetta comunque la richiesta ma semplicemente non produce il messaggio. Per impostazione predefinita, la segnalazione dello stato dell'indirizzo e della riga è inizialmente disabilitata per una riga.

Questa funzione è diversa dalla funzione TAPI corrispondente, come indicato di seguito: (1) Il set di messaggi richiesti è l'unione di tutti i set richiesti dalle applicazioni a livello TAPI. (2) Il set di messaggi non viene ridotto né incrementato in base alla proprietà (perché non esiste alcun concetto di proprietà a livello TSPI) (3) Il set è consultivo nel senso che il provider di servizi deve inoltrare almeno il set indicato di messaggi, ma è autorizzato a inoltrare un set più grande.

Le modifiche dello stato del dispositivo relative all'apertura e alla chiusura non vengono segnalate, perché a livello TSPI è presente una sola apertura in sospeso alla volta.