LINE_NEWCALL 메시지
TSPI LINE_NEWCALL 메시지는 TAPI가 시작되지 않은 새 호출이 TAPI가 열려 있는 줄에 도착할 때마다 LINEEVENT 콜백 함수로 전송됩니다. 이 메시지는 해당 호출과 관련하여 전송된 첫 번째 메시지여야 합니다. TAPI는 서비스 공급자가 dwParam2로 전달한 위치에 htCall 불투명 핸들을 씁니다. 이렇게 하면 서비스 공급자에게 후속 메시지에 사용할 htCall 값을 제공합니다.
매개 변수
-
htLine
-
줄 디바이스에 대한 TAPI 불투명 개체 핸들입니다.
-
htCall
-
사용되지 않습니다.
-
dwMsg
-
LINE_NEWCALL 값입니다.
-
dwParam1
-
HDRVCALL 형식의 호출에 대한 서비스 공급자의 불투명 핸들입니다. TAPI는 호출에서 작동하기 위해 호출하는 후속 절차에서 호출을 식별하기 위해 이 값을 hdCall 매개 변수로 전달합니다.
-
dwParam2
-
HTAPICALL을 가리키는 LPHTAPICALL 형식의 포인터입니다. TAPI는 표시된 위치에 대한 호출에 대한 TAPI 불투명 핸들을 씁니다. 서비스 공급자는 이 값을 저장하고 htCall 매개 변수로 전달하여 호출에 대해 보고하는 후속 이벤트에서 호출을 식별해야 합니다.
이 매개 변수는 NULL 값을 가져올 수도 있습니다(다음 설명 섹션 참조).
-
dwParam3
-
사용되지 않습니다.
설명
서비스 공급자는 이 호출의 다음 메시지로 LINE_CALLSTATE 메시지를 보내야 합니다. LINE_NEWCALL 이벤트는 값도 서비스 공급자에게 다시 전달한다는 측면에서는 이례적인 일입니다.
이 함수는 TAPI와 서비스 공급자가 아직 불투명 핸들을 교환하지 않은 서비스 공급자(인바운드, 아웃바운드, 휴대폰에서 시작 등)에서 발생하는 모든 새 호출을 보고합니다. 핸들은 TAPI와 서비스 공급자가 이후에 호출과 관련된 요청 및 보고서 이벤트를 만들 수 있도록 교환됩니다. 이러한 새 호출이 반드시 인바운드되는 것은 아니므로 호출은 처음에 제공 상태가 아닌 모든 상태에 있을 수 있습니다. 서비스 공급자가 시작되고 하나 이상의 호출이 줄에서 이미 활성 상태임을 발견하면 LINE_NEWCALL 메시지와 현재 상태를 나타내는 LINE_CALLSTATE 메시지가 차례로 포함된 TAPI에 알릴 수 있습니다. 사용자가 휴대폰에서 시작한 새 발신 통화는 LINE_NEWCALL 메시지와 함께 보고되며, 초기 LINE_CALLSTATE 메시지는 통화가 DIALTONE 상태임을 나타냅니다(그런 다음 계속 진행).
서비스 공급자가 매우 짧은 시간(동일한 인터럽트 주기 동안)에 TAPI에 많은 수의 호출을 전달하는 경우 TAPI는 해당 호출을 처리하는 데 백로그될 수 있습니다. 이 경우 TAPI는 서비스 공급자에게 더 이상 호출을 보내기 전에 잠시 기다리도록 신호를 보냅니다. 유효한 HTAPICALL 대신 NULL 값을 LINE_NEWCALLdwParam2 매개 변수가 가리키는 위치에 기록하여 이 신호를 보냅니다. 이는 메모리를 일시적으로 할당할 수 없기 때문에 새로 제공된 호출 핸들을 처리하려는 시도가 성공하지 못했음을 나타냅니다. 서비스 공급자는 호출을 삭제하거나 예약 지연 후 LINE_NEWCALL 메시지를 다시 전송하여 응답할 수 있습니다(이 기간 동안 서비스 공급자는 TAPI가 다른 보류 중인 작업을 처리할 수 있도록 프로세서를 생성해야 합니다). 어떤 경우에도 핸들 교환이 성공할 때까지 새 호출과 관련된 추가 메시지를 TAPI에 전달할 수 없습니다. dwParam2가 가리키는 위치가 NULL이 아닌 값을 획득하면 서비스 공급자는 이 값이 호출에 대한 유효한 HTAPICALL 핸들임을 알고 있습니다.
TAPI 수준에서 직접 해당 메시지가 없습니다. 이 메시지는 TSPI 수준에서 TAPI에 대한 새 수신 호출을 고유하고 명확하게 도입하고 호출에 대한 TAPI 불투명 식별자를 검색하는 데 사용됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| TAPI 버전 |
TAPI 2.0 이상이 필요합니다. |
| 헤더 |
|