TSPI_phoneOpen 함수(tspi.h)

아티클
08/26/2023

TSPI_phoneOpen 함수는 디바이스 식별자가 지정된 휴대폰 디바이스를 열고, 디바이스에 대한 서비스 공급자의 불투명 핸들을 반환하고, PHONEEVENT 프로시저에 대한 후속 호출에 사용할 수 있도록 디바이스에 대한 TAPI의 불투명 핸들을 유지합니다.

구문

LONG TSPIAPI TSPI_phoneOpen(
  DWORD       dwDeviceID,
  HTAPIPHONE  htPhone,
  LPHDRVPHONE lphdPhone,
  DWORD       dwTSPIVersion,
  PHONEEVENT  lpfnEventProc
);

매개 변수

dwDeviceID

열 휴대폰 디바이스입니다.

htPhone

PHONEEVENT 콜백 프로시저에 대한 후속 호출에서 디바이스를 식별하는 데 사용할 휴대폰 디바이스에 대한 TAPI 불투명 핸들입니다.

lphdPhone

서비스 공급자가 후속 호출에서 TAPI에서 디바이스를 식별하는 데 사용할 휴대폰 디바이스에 대한 핸들을 쓰는 HDRVPHONE 에 대한 포인터입니다.

dwTSPIVersion

서비스 공급자가 작동할 수 있는 TSPI_phoneNegotiateTSPIVersion 통해 협상된 TSPI 버전입니다.

lpfnEventProc

서비스 공급자가 전화에서 후속 이벤트를 보고하기 위해 호출하는 TAPI에서 제공하는 PHONEEVENT 콜백 프로시저에 대한 포인터입니다.

반환 값

함수가 성공하면 0을 반환하고 오류가 발생하면 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.

PHONEERR_ALLOCATED, PHONEERR_NOMEM, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_INUSE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INIFILECORRUPT.

설명

휴대폰을 열면 TAPI가 휴대폰에서 추가 요청을 할 수 있습니다. 휴대폰은 서비스 공급자가 후크 위치 변경 또는 단추 누름과 같은 비동기 이벤트를 보고할 수 있다는 점에서 활성화됩니다. 서비스 공급자는 휴대폰을 관리하는 데 필요한 공유 불가능한 리소스를 예약합니다. 예를 들어 comm 포트 및 모뎀을 통해 액세스하는 휴대폰을 열면 comm 포트가 열리므로 다른 애플리케이션에서 더 이상 사용할 수 없게 됩니다.

함수가 성공하면 TAPI와 서비스 공급자가 모두 이 열린 디바이스에 대해 지정된 인터페이스 버전 번호로 작동하도록 커밋됩니다. 교환된 불투명 전화 핸들을 사용하여 식별된 후속 작업 및 이벤트는 해당 인터페이스 버전을 준수합니다. TAPI가 TSPI_phoneClose 사용하여 전화를 닫거나 서비스 공급자가 PHONE_CLOSE 이벤트를 보고 할 때까지 이 약정 및 핸들의 유효성은 계속 적용됩니다. 함수가 성공하지 못하면 이러한 약정이 수행되지 않으며 핸들이 유효하지 않습니다.