funzione TSPI_providerEnumDevices (tspi.h)

Articolo
03/13/2024

TAPI chiama la funzione TSPI_providerEnumDevices prima di TSPI_providerInit per determinare il numero di dispositivi line e phone supportati dal provider di servizi.

Sintassi

LONG TSPIAPI TSPI_providerEnumDevices(
  DWORD      dwPermanentProviderID,
  LPDWORD    lpdwNumLines,
  LPDWORD    lpdwNumPhones,
  HPROVIDER  hProvider,
  LINEEVENT  lpfnLineCreateProc,
  PHONEEVENT lpfnPhoneCreateProc
);

Parametri

dwPermanentProviderID

Identificatore permanente, univoco all'interno dei provider di servizi in questo sistema, del provider di servizi inizializzato.

lpdwNumLines

Puntatore a una posizione di memoria di dimensioni DWORD in cui il provider di servizi deve scrivere il numero di dispositivi line configurati per il supporto. TAPI inizializza il valore su 0, quindi se il provider di servizi non riesce a scrivere un valore diverso, si presuppone che il valore 0.

lpdwNumPhones

Puntatore a una posizione di memoria di dimensioni DWORD in cui il provider di servizi deve scrivere il numero di dispositivi telefonici configurati per il supporto. TAPI inizializza il valore su 0, quindi se il provider di servizi non riesce a scrivere un valore diverso, si presuppone che il valore 0.

hProvider

Valore DWORD opaco che identifica in modo univoco questa istanza del provider di servizi durante questa esecuzione dell'ambiente di telefonia.

lpfnLineCreateProc

Puntatore alla routine di callback LINEEVENT fornita da TAPI. Il provider di servizi usa questa funzione per inviare LINE_CREATE messaggi quando è necessario creare un nuovo dispositivo di riga.

lpfnPhoneCreateProc

Puntatore alla routine di callback PHONEEVENT fornita da TAPI. Il provider di servizi usa questa funzione per inviare PHONE_CREATE messaggi quando deve essere creato un nuovo dispositivo telefonico.

Valore restituito

Restituisce zero se la richiesta ha esito positivo o se si verifica un errore. I valori restituiti possibili sono:

LINEERR_NOMEM, LINEERR_OPERATIONFAILED.

Commenti

Nelle versioni precedenti di TAPI, l'implementazione di questa funzione era facoltativa. A partire da TAPI 2.0, l'implementazione di questa funzione è obbligatoria in tutti i provider di servizi. TAPI non controlla più Telephon.ini o registro all'avvio TAPI per determinare il numero iniziale di righe e telefoni supportati da un provider di servizi.

Un nuovo dispositivo può essere visualizzato prima del completamento della procedura di TSPI_providerInit . TAPI gestisce correttamente tutti i messaggi _CREATE durante l'inizializzazione del provider.