LINE_CALLSTATE 메시지
TAPI LINE_CALLSTATE 메시지는 지정된 호출의 상태 변경될 때 전송됩니다. 일반적으로 이러한 여러 메시지는 통화 수명 동안 수신됩니다. 애플리케이션은 이 메시지와 함께 들어오는 새 호출에 대한 알림을 받습니다. 새 호출이 제공 상태에 있습니다. 애플리케이션은 lineGetCallStatus를 사용하여 호출의 현재 상태 대한 자세한 정보를 검색할 수 있습니다.
매개 변수
-
hDevice
-
호출에 대한 핸들입니다.
-
dwCallbackInstance
-
콜백 instance 호출의 줄을 열 때 제공됩니다.
-
dwParam1
-
새 호출 상태입니다. 이 매개 변수는 다음 LINECALLSTATE_ 상수 중 하나여야 합니다.
dwParam1 의미 - LINECALLSTATE_BUSY
dwParam2 에는 사용 중인 모드에 대한 세부 정보가 포함되어 있습니다. 이 매개 변수는 LINEBUSYMODE_ 상수 중 하나를 사용합니다. - LINECALLSTATE_CONNECTED
dwParam2 에는 연결된 모드에 대한 세부 정보가 포함되어 있습니다. 이 매개 변수는 LINECONNECTEDMODE_ 상수 중 하나를 사용합니다. - LINECALLSTATE_DIALTONE
dwParam2 에는 다이얼 톤 모드에 대한 세부 정보가 포함되어 있습니다. 이 매개 변수는 LINEDIALTONEMODE_ 상수 중 하나를 사용합니다. - LINECALLSTATE_OFFERING
dwParam2 에는 연결된 모드에 대한 세부 정보가 포함되어 있습니다. 이 매개 변수는 LINEOFFERINGMODE_ 상수 중 하나를 사용합니다. - LINECALLSTATE_SPECIALINFO
dwParam2 에는 특수 정보 모드에 대한 세부 정보가 포함되어 있습니다. 이 매개 변수는 LINESPECIALINFO_ 상수 중 하나를 사용합니다. - LINECALLSTATE_DISCONNECTED
dwParam2 에는 연결 끊기 모드에 대한 세부 정보가 포함되어 있습니다. 이 매개 변수는 LINEDISCONNECTMODE_ 상수 중 하나를 사용합니다. -
dwParam2
-
호출 상태 종속 정보입니다. dwParam1을 참조하세요.
참고
지연된 응답이 적절한 경우 LINEDISCONNECTMODE_TEMPFAILURE 사용합니다. 차단 목록에 있는 응답이 적절한 경우 LINEDISCONNECT_BLOCKED 사용합니다. 자세한 내용은 LINEDISCONNECTMODE_ 상수를 참조하세요.
dwParam1이 LINECALLSTATE_CONFERENCED 경우 dwParam2에는 hCall 주제가 멤버인 회의의 부모 호출에 대한 hConfCall 매개 변수가 포함됩니다. dwParam2에 지정된 호출이 이전에 애플리케이션에서 부모 전화 회의 호출로 간주되지 않은 경우(hConfCall, 애플리케이션은 이 메시지의 결과로 그렇게 해야 합니다. 애플리케이션에 회의의 부모 호출에 대한 핸들이 없는 경우(이전에 해당 핸들에서 lineDeallocateCall 을 호출했기 때문에) dwParam2 는 NULL로 설정됩니다.
-
dwParam3
-
0이면 이 매개 변수는 호출에 대한 애플리케이션의 권한이 변경되지 않음을 나타냅니다.
0이 아닌 경우 호출에 대한 애플리케이션의 권한을 지정합니다. (1) 애플리케이션에 이 호출에 대한 핸들이 처음 제공된 경우 이 문제가 발생합니다. (2) 애플리케이션이 호출 핸드오프의 대상인 경우(애플리케이션이 이미 호출 소유자인 경우에도) 이 매개 변수는 다음 LINECALLPRIVILEGE_ 상수 중 하나를 사용합니다.
반환 값
반환 값이 없습니다.
설명
이 메시지는 호출에 대한 핸들이 있는 모든 애플리케이션으로 전송됩니다. 또한 LINE_CALLSTATE 메시지는 다른 애플리케이션에서 설정하거나 사용자가 수동으로 설정한 아웃바운드 호출의 존재 및 상태(예: 연결된 전화 장치)에 대한 호출을 모니터링하는 애플리케이션에 알 수 있습니다. 이러한 호출의 호출 상태는 제공하지 않는 호출의 실제 상태를 반영합니다. 호출 상태를 검사하여 애플리케이션은 호출이 응답해야 하는 인바운드 호출인지 여부를 확인할 수 있습니다.
알 수 없는 호출 상태가 있는 LINE_CALLSTATE 메시지는 다른 애플리케이션에서 요청한 lineMakeCall, lineForward, lineUnpark, lineSetupTransfer, linePickup, lineSetupConference 또는 linePrepareAddToConference 의 결과로 모니터링 애플리케이션으로 보낼 수 있습니다. 요청된 애플리케이션이 요청된 작업에 대한 LINE_REPLY (성공)을 보내는 동시에 줄의 모니터링 애플리케이션은 LINE_CALLSTATE (알 수 없음) 메시지를 보냅니다. 새로 생성된 호출의 "실제" 호출 상태를 나타내는 LINE_CALLSTATE 메시지가 곧 요청 및 모니터링 애플리케이션에 전송됩니다(서비스 공급자가 제공한 정보 사용).
lineCompleteTransfer로 인해 호출이 3방향 회의로 확인되는 경우에만 모니터링 애플리케이션에 LINE_CALLSTATE(알 수 없음) 메시지가 전송됩니다.
이전 버전과의 호환성을 위해 이전 애플리케이션은 LINECALLSTATE_CONFERENCED 메시지의 dwParam2 에서 특정 값을 기대하지 않습니다. 따라서 TAPI는 메시지를 수신하는 애플리케이션의 API 버전에 관계없이 dwParam2에서 hConfCall 부모 호출을 전달합니다. 서비스 공급자가 시작한 전화 회의의 경우 다른 정보(예: call lineGetConfRelatedCalls)를 자발적으로 검사하지 않는 한 이전 애플리케이션은 부모 호출이 전화 회의 호출이 되었다는 사실을 인식하지 않습니다.
이 메시지를 사용하지 않도록 설정할 수 없습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| TAPI 버전 |
TAPI 2.0 이상이 필요합니다. |
| 헤더 |
|
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기