LINE_APPNEWCALL 메시지
TAPI LINE_APPNEWCALL 메시지는 새 호출 핸들이 자동으로 생성되었을 때 애플리케이션에 알리기 위해 전송됩니다(애플리케이션의 API 호출을 통하지 않는 경우 핸들이 함수에 전달된 포인터 매개 변수를 통해 반환됨).
매개 변수
-
hDevice
-
호출이 만들어진 라인 디바이스에 대한 애플리케이션의 핸들입니다.
-
dwCallbackInstance
-
콜백은 호출의 줄을 열 때 제공된 instance.
-
dwParam1
-
호출이 표시되는 줄에 있는 주소의 식별자입니다. 주소 식별자는 주소와 영구적으로 연결됩니다. 식별자는 운영 체제 업그레이드에서 일정하게 유지됩니다.
-
dwParam2
-
새 호출에 대한 애플리케이션의 핸들입니다.
-
dwParam3
-
새 호출에 대한 애플리케이션 권한(LINECALLPRIVILEGE_OWNER 또는 LINECALLPRIVILEGE_MONITOR)입니다.
반환 값
반환 값이 없습니다.
설명
TAPI 버전 2.0 이상을 지원하는 애플리케이션은 애플리케이션이 새 호출에 대한 핸들을 자발적으로 부여할 때마다 LINE_APPNEWCALL 메시지를 보냅니다. 메시지에는 호출이 있는 hLine 및 dwAddressID 매개 변수가 포함되어 있으므로 애플리케이션은 올바른 컨텍스트에서 새 호출 개체를 쉽게 만들 수 있습니다. LINE_APPNEWCALL 메시지에는 항상 즉시 호출의 초기 상태를 나타내는 LINE_CALLSTATE 메시지가 표시됩니다.
이전 버전의 API에 설명된 대로 이전 애플리케이션(2.0 이전의 API 버전 협상)은 LINE_CALLSTATE 메시지만 전송됩니다. 이러한 애플리케이션은 dwParam3이 0이 아닌 값으로 설정된 LINE_CALLSTATE 메시지를 수신하고 현재 애플리케이션에서 알 수 없는 호출 핸들을 포함하는 새 호출 개체를 만듭니다. 단점은 (a) 애플리케이션이 lineGetCallInfo를 호출하여 호출과 연결된 hLine 및 dwAddressID 매개 변수를 결정해야 한다는 것입니다. (b) 애플리케이션은 알려진 모든 호출 핸들을 검사하여 호출이 새 호출인지 확인해야 합니다. 및 (c) 특정 조건에서 애플리케이션이 실제로 호출에 대한 핸들의 할당을 취소했을 때 새 호출 핸들을 수신하고 있다고 생각할 수 있습니다(예: 애플리케이션이 통화 핸들의 할당을 취소했지만 다른 애플리케이션의 lineHandoff로 인해 호출의 애플리케이션 소유권을 제공하는 LINE_CALLSTATE 메시지는 이미 애플리케이션의 TAPI 메시지 큐에 있었습니다).
요구 사항
| 요구 사항 | 값 |
|---|---|
| TAPI 버전 |
TAPI 2.0 이상이 필요합니다. |
| 헤더 |
|