funzione phoneDevSpecific (tapi.h)

Articolo
03/08/2023

La funzione phoneDevSpecific viene usata come meccanismo di estensione generale per consentire a un'implementazione dell'API di telefonia di fornire funzionalità non descritte nelle altre funzioni TAPI. I significati di queste estensioni sono specifici del dispositivo.

Sintassi

LONG phoneDevSpecific(
  HPHONE hPhone,
  LPVOID lpParams,
  DWORD  dwSize
);

Parametri

hPhone

Gestire un dispositivo telefonico.

lpParams

Puntatore a un'area di memoria usata per contenere un blocco di parametri. La sua interpretazione è specifica del dispositivo. Il contenuto del blocco di parametri viene passato invariato a o dal provider di servizi da TAPI.

dwSize

Dimensioni dell'area del blocco dei parametri, in byte.

Valore restituito

Restituisce un identificatore di richiesta positivo se la funzione viene completata in modo asincrono o un numero di errore negativo se si verifica un errore. Il parametro dwParam2 del messaggio di PHONE_REPLY corrispondente è zero se la funzione ha esito positivo o è un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONFAILED.

I valori restituiti aggiuntivi sono specifici del dispositivo.

Commenti

Questa operazione fornisce un profilo di parametro generico. L'interpretazione del blocco di parametri è specifica del dispositivo. Le indicazioni e le risposte specifiche del dispositivo devono usare il messaggio di PHONE_DEVSPECIFIC .

Un provider di servizi può fornire l'accesso alle funzioni specifiche del dispositivo definendo i parametri da usare con questa operazione. Le applicazioni che vogliono usare queste estensioni specifiche del dispositivo devono consultare la documentazione specifica del dispositivo (specifica del fornitore) che descrive quali estensioni sono definite. In genere, un'applicazione che si basa su queste estensioni specifiche del dispositivo non è portabile per lavorare con altri ambienti del provider di servizi.