숫자 모니터링을 사용하도록 설정하고 한 번에 한 자릿수에 대한 알림을 받는 것 외에도 애플리케이션은 버퍼에서 여러 숫자를 수집하도록 요청할 수 있습니다. 버퍼가 가득 차거나 다른 종료 조건이 충족되는 경우에만 애플리케이션에 알림이 표시됩니다. 숫자 수집은 신용 카드 번호 수집과 같은 기능에 유용합니다. 애플리케이션이 lineGatherDigits호출하여 숫자로 채울 버퍼를 지정할 때 수행됩니다. 다음 조건 중 하나가 true이면 숫자 수집이 종료됩니다.
- 요청된 숫자 수가 수집되었습니다.
- 여러 종료 숫자 중 하나가 검색됩니다. 종료 숫자는 lineGatherDigits지정되며 종료 숫자도 버퍼에 배치됩니다.
- 두 시간 제한 중 하나가 만료됩니다. 시간 제한에는 두 가지 유형이 있습니다. 첫 번째 숫자 시간 제한은 처음 숫자를 수집하기 전의 최대 시간을 지정하고, 숫자 간 시간 제한은 연속되는 숫자 사이의 최대 지속 시간을 지정합니다.
- lineGatherDigits가 다른 매개 변수 집합을 사용하여 새 수집 요청을 시작하거나 NULL 숫자 버퍼 매개 변수를 사용하여 다시 숫자 수집이 명시적으로 취소됩니다.
어떤 이유로든 숫자 수집이 종료되면 LINE_GATHERDIGITS 메시지가 숫자 수집을 요청한 애플리케이션으로 전송됩니다. 호출의 소유자인 모든 애플리케이션에서는 어느 시점에든 단일 숫자 수집 요청만 호출에 대해 미해결 상태로 남아 있을 수 있습니다.
숫자 수집 및 숫자 모니터링은 동일한 호출에서 동시에 사용하도록 설정할 수 있습니다. 이 경우 애플리케이션은 버퍼가 다시 전송될 때 검색된 각 숫자에 대한 LINE_MONITORDIGITS 메시지와 별도의 LINE_GATHERDIGITS 메시지를 받습니다.