funzione lineGenerateDigitsA (tapi.h)

La funzione lineGenerateDigits avvia la generazione delle cifre specificate nella chiamata specificata come toni di banda usando la modalità di segnalazione specificata. La chiamata a questa funzione con un valore NULL per lpszDigits interrompe qualsiasi generazione di cifre attualmente in corso. Richiamando rigaGenerateDigits o lineGenerateTone mentre la generazione di cifre è in corso interrompe la generazione o il tono della cifra corrente e avvia la generazione delle cifre o del tono specificate più di recente.

Sintassi

LONG lineGenerateDigitsA(
  HCALL  hCall,
  DWORD  dwDigitMode,
  LPCSTR lpszDigits,
  DWORD  dwDuration
);

Parametri

hCall

Gestire la chiamata. L'applicazione deve essere un proprietario della chiamata. Lo stato della chiamata di hCall può essere qualsiasi stato. TAPI non impone alcun requisito di callstate, tuttavia alcuni provider di servizi Tapi potrebbero richiedere che hCall sia nello stato LINECALLSTATE_CONNECTED.

dwDigitMode

Formato da usare per segnalare queste cifre. Tenere presente che dwDigitMode può avere un solo flag impostato. Questo parametro usa una delle costanti LINEDIGITMODE_.

lpszDigits

Puntatore a un nullbuffer di caratteri con terminazione contenente le cifre da generare. I caratteri validi sono quelli specificati per le costanti LINEDIGITMODE_ fornite in dwDigitModes.

Inoltre, la virgola (,) è anche un carattere valido. Una virgola inserisce un ritardo aggiuntivo tra la segnalazione delle cifre precedenti e successive che separa. La durata di questa pausa è definita dalla configurazione e le funzionalità del dispositivo line indicano questa durata. È possibile usare più virgole per inserire pause più lunghe. Le cifre non valide vengono ignorate durante la generazione, anziché essere segnalate come errori.

Il punto esclamativo (!) è un carattere valido. Questo carattere causa un'operazione "hookflash", come descritto per indirizzi dialable.

dwDuration

Sia la durata in millisecondi delle cifre DTMF e della spaziatura inter-cifra DTMF. Il valore 0 usa un valore predefinito. Il parametro dwDuration deve essere compreso nell'intervallo specificato da MinDialParams e MaxDialParams in LINEDEVCAPS. Se non è compreso nell'intervallo, il valore effettivo viene impostato sul valore più vicino nell'intervallo.

Valore restituito

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

LINEERR_INVALCALLHANDLE, LINEERR_NOTOWNER, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALDIGITMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM LINEERR_UNINITIALIZED.

Osservazioni

La rigaGenerateDigits funzione viene considerata completata correttamente quando la generazione delle cifre è stata avviata correttamente, non quando sono state generate tutte le cifre. A differenza di lineDial, che compone cifre in modo dipendente dalla rete, lineGenerateDigits garantisce di produrre le cifre come toni di banda sul canale vocale tramite DTMF o impulsi di composizione hookswitch quando si utilizza l'impulso. La funzione lineGenerateDigits non è in genere adatta per effettuare chiamate o composizione. È destinato alla segnalazione end-to-end su una chiamata stabilita.

Dopo che tutte le cifre in lpszDigits sono state generate o dopo l'interruzione o l'annullamento della generazione di cifre, viene inviato un messaggio LINE_GENERATE all'applicazione.

Una sola richiesta di generazione inband (generazione di toni o generazione di cifre) può essere in corso per ogni chiamata in tutte le applicazioni proprietari della chiamata. La generazione di cifre in una chiamata viene annullata avviando un'altra richiesta di generazione di cifre o una richiesta di generazione del tono. Per annullare la generazione di cifre correnti, l'applicazione può richiamare lineGenerateDigits e specificare NULL per il parametro lpszDigits.

A seconda del provider di servizi e dell'hardware, l'applicazione può monitorare le cifre generate. Se non lo si desidera, l'applicazione può disabilitare il monitoraggio delle cifre durante la generazione di cifre.

Nota

L'intestazione tapi.h definisce lineGenerateDigits come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	tapi.h
libreria	Tapi32.lib
dll	Tapi32.dll

Vedere anche

LINEDEVCAPS

LINE_GENERATE

funzioni supplementari del servizio linea

panoramica dei riferimenti TAPI 2.2

lineDial

lineGenerateTone