TSPI_lineOpen 함수(tspi.h)

아티클
03/03/2024

TSPI_lineOpen 함수는 디바이스 식별자가 지정된 줄 디바이스를 열고 디바이스에 대한 서비스 공급자의 핸들을 반환합니다. 서비스 공급자는 LINEEVENT 콜백 프로시저에 대한 후속 호출에 사용할 디바이스에 대한 TAPI 핸들을 유지해야 합니다.

구문

LONG TSPIAPI TSPI_lineOpen(
  DWORD      dwDeviceID,
  HTAPILINE  htLine,
  LPHDRVLINE lphdLine,
  DWORD      dwTSPIVersion,
  LINEEVENT  lpfnEventProc
);

매개 변수

dwDeviceID

열 줄 디바이스를 식별합니다.

htLine

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

lphdLine

서비스 공급자가 줄 디바이스에 대한 핸들을 채우는 HDRVLINE 에 대한 포인터입니다.

dwTSPIVersion

TSPI 버전입니다.

lpfnEventProc

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

반환 값

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

LINEERR_ALLOCATED, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

설명

서비스 공급자는 줄을 관리하는 데 필요한 공유 불가능한 리소스를 예약해야 합니다. 그러나 lineMakeCall 로 연기할 수 있는 모든 작업은 이어야 합니다. LINEOpen이 "저렴한" 작업이라는 것은 TAPI의 디자인 가정입니다. 예를 들어 모니터 모드에서만 줄을 열면 COMM 포트 기반 서비스 공급자가 COMM 포트를 열 필요가 없습니다.

이 프로시저는 TAPI 수준에서 디바이스별 확장을 사용하도록 설정하고, 선 특성을 선택하고, 미디어 유형 검색을 설정하는 기능이 lineOpen에 정의된 기능에 포함된 모든 프로시저와 직접 일치하지 않습니다. TSPI 수준에서 이러한 추가 기능은 TSPI_lineNegotiateExtVersion, TSPI_lineSetDefaultMediaDetection 및 TSPI_lineConditionalMediaDetection 구분됩니다.