Metodo ITLegacyCallMediaControl2::GatherDigits (tapi3if.h)

Il metodo GatherDigits avvia la raccolta di cifre nella chiamata specificata. L'applicazione specifica il numero massimo di cifre da raccogliere.

Sintassi

HRESULT GatherDigits(
  [in] TAPI_DIGITMODE DigitMode,
  [in] long           lNumDigits,
  [in] BSTR           pTerminationDigits,
  [in] long           lFirstDigitTimeout,
  [in] long           lInterDigitTimeout
);

Parametri

[in] DigitMode

Modalità cifre da monitorare. Questo parametro specifica una o più costanti LINEDIGITMODE .

[in] lNumDigits

Numero di cifre da raccogliere.

Se questo parametro è zero, il metodo annulla qualsiasi raccolta cifre in corso, senza avviare un nuovo tentativo di raccolta cifre. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

[in] pTerminationDigits

Puntatore a una rappresentazione BSTR delle cifre di terminazione. Se viene rilevata una delle cifre di terminazione nella stringa, tale cifra viene aggiunta al buffer, la raccolta di cifre viene terminata e l'evento TE_GATHERDIGITS viene inviato all'applicazione.

[in] lFirstDigitTimeout

Durata del tempo, in millisecondi, durante la quale è prevista la prima cifra. Se la prima cifra non viene ricevuta in questo intervallo di tempo, la raccolta cifre viene interrotta e viene inviato un evento TE_GATHERDIGITS all'applicazione. Il buffer contiene solo il carattere NULL , che indica che non sono state ricevute cifre e che la prima cifra-timeout ha terminato la raccolta di cifre. I timeout minimi e massimi che è possibile specificare sono disponibili nelle funzionalità di AC_GATHERDIGITSMINTIMEOUT e AC_GATHERDIGITSMAXTIMEOUT.

[in] lInterDigitTimeout

Tempo massimo, in millisecondi, tra cifre consecutive. Se la cifra successiva non viene ricevuta in questo intervallo di tempo, la raccolta di cifre viene interrotta e viene inviato un evento TE_GATHERDIGITS all'applicazione. Il buffer contiene solo le cifre raccolte fino a questo punto seguito da un carattere NULL , che indica che un timeout interdigit termina la raccolta cifre. I timeout minimi e massimi che possono essere specificati sono disponibili nelle funzionalità di AC_GATHERDIGITSMINTIMEOUT e AC_GATHERDIGITSMAXTIMEOUT.

Valore restituito

Questo metodo può restituire uno di questi valori.

Commenti

Il metodo GatherDigits si traduce in una chiamata al TAPI 2. funzione xlineGatherDigits .

Una sola chiamata GatherDigits può essere in sospeso su una chiamata. Se si chiama di nuovo GatherDigits , prima che si sia verificato l'evento TE_GATHERDIGITS , la seconda chiamata annulla la raccolta precedente di cifre. I tentativi di raccolta cifre annullati inviano un evento TE_GATHERDIGITS con le cifre raccolte finora.

Requisiti

Vedi anche

ITLegacyCallMediaControl2