Digit Gathering

Besides enabling digit monitoring and being notified of digits one at a time, tapi32.dll can also request that multiple digits be collected in a buffer. Only when the buffer is full or when some other termination condition is met is tapi32.dll notified. Digit gathering is useful for functions such as credit card number collection. tapi32.dll invokes TSPI_lineGatherDigits, specifying a buffer to fill with digits. Digit gathering terminates when one of a number of conditions is true.

When terminated for whatever reason, a LINE_GATHERDIGITS message is sent to the application that requested the digit gathering.

Note  Only a single digit gathering request can be outstanding on a call at any given time.

Digit gathering and digit monitoring can be enabled on the same call at the same time. In that case, tapi32.dll receives a LINE_MONITORDIGITS message for each detected digit and a separate LINE_GATHERDIGITS message when the buffer is sent back.