LINE_GATHERDIGITS 메시지
TAPI LINE_GATHERDIGITS 메시지는 현재 버퍼링된 숫자 수집 요청이 종료되었거나 취소될 때 전송됩니다. 이 메시지를 애플리케이션에서 받은 후 숫자 버퍼를 검사할 수 있습니다.
매개 변수
-
hDevice
-
호출에 대한 핸들입니다.
-
dwCallbackInstance
-
선을 열 때 제공된 콜백 instance.
-
dwParam1
-
숫자 수집이 종료된 이유입니다. 이 매개 변수는 LINEGATHERTERM_ 상수 중 하나여야 합니다.
-
dwParam2
-
사용되지 않습니다.
-
dwParam3
-
숫자 수집이 완료된 "틱 수"(Windows가 시작된 이후의 시간(밀리초))입니다. 2.0 이전의 TAPI 버전의 경우 이 매개 변수는 사용되지 않습니다.
반환 값
반환 값이 없습니다.
설명
LINE_GATHERDIGITS 메시지는 lineGatherDigits를 사용하여 호출에서 숫자 수집을 시작한 애플리케이션으로만 전송됩니다.
lineGatherDigits 함수를 사용하여 숫자를 수집하기 위한 이전 요청을 취소하는 경우 TAPI는 dwParam1이 설정된 LINE_GATHERDIGITS 메시지를 애플리케이션에 LINEGATHERTERM_CANCEL 보내 원래 지정된 버퍼에 취소까지 수집된 숫자가 포함되어 있음을 나타냅니다.
dwParam3에서 지정한 타임스탬프는 애플리케이션이 실행 중인 컴퓨터가 아닌 다른 컴퓨터에서 생성되었을 수 있으므로 상대 타이밍(이벤트 간 분리)을 결정하기 위해 동일한 줄 디바이스(LINE_GENERATE, LINE_MONITORDIGITS, LINE_MONITORMEDIA, LINE_MONITORTONE)에서 생성된 다른 유사한 타임스탬프 메시지와 비교하는 데만 유용합니다. 틱 수는 약 49.7일 후에 "래핑"할 수 있습니다. 애플리케이션은 계산을 수행할 때 이를 고려해야 합니다.
서비스 공급자가 타임스탬프를 생성하지 않는 경우(예: 이전 버전의 TAPI를 사용하여 만든 경우) TAPI는 합성된 타임스탬프가 가능한 한 정확하도록 이벤트를 생성하는 서비스 공급자와 가장 가까운 지점에 타임스탬프를 제공합니다.
참고
애플리케이션이 애플리케이션 메모리에 데이터를 다시 쓰는 비동기 작업을 호출하는 경우 애플리케이션은 LINE_REPLY 또는 LINE_GATHERDIGITS 메시지가 수신될 때까지 해당 메모리를 쓰기에 사용할 수 있도록 유지해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| TAPI 버전 |
TAPI 2.0 이상이 필요합니다. |
| 헤더 |
|