TSPI_providerEnumDevices 함수(tspi.h)

아티클
03/03/2024

TAPI는 TSPI_providerInit 전에 TSPI_providerEnumDevices 함수를 호출하여 서비스 공급자가 지원하는 회선 및 전화 디바이스의 수를 확인합니다.

구문

LONG TSPIAPI TSPI_providerEnumDevices(
  DWORD      dwPermanentProviderID,
  LPDWORD    lpdwNumLines,
  LPDWORD    lpdwNumPhones,
  HPROVIDER  hProvider,
  LINEEVENT  lpfnLineCreateProc,
  PHONEEVENT lpfnPhoneCreateProc
);

매개 변수

dwPermanentProviderID

이 시스템의 서비스 공급자 내에서 고유하게 초기화되는 서비스 공급자의 영구 식별자입니다.

lpdwNumLines

서비스 공급자가 지원하도록 구성된 줄 디바이스 수를 작성해야 하는 DWORD 크기의 메모리 위치에 대한 포인터입니다. TAPI는 값을 0으로 초기화하므로 서비스 공급자가 다른 값을 작성하지 못하면 값 0이 가정됩니다.

lpdwNumPhones

서비스 공급자가 지원하도록 구성된 전화 디바이스 수를 작성해야 하는 DWORD 크기의 메모리 위치에 대한 포인터입니다. TAPI는 값을 0으로 초기화하므로 서비스 공급자가 다른 값을 작성하지 못하면 값 0이 가정됩니다.

hProvider

전화 통신 환경을 실행하는 동안 이 서비스 공급자의 이 instance 고유하게 식별하는 불투명 DWORD 크기 값입니다.

lpfnLineCreateProc

TAPI에서 제공하는 LINEEVENT 콜백 프로시저에 대한 포인터입니다. 서비스 공급자는 새 줄 디바이스를 만들어야 할 때 이 함수를 사용하여 LINE_CREATE 메시지를 보냅니다.

lpfnPhoneCreateProc

TAPI에서 제공하는 PHONEEVENT 콜백 프로시저에 대한 포인터입니다. 서비스 공급자는 새 휴대폰 디바이스를 만들어야 할 때 이 함수를 사용하여 PHONE_CREATE 메시지를 보냅니다.

반환 값

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

LINEERR_NOMEM, LINEERR_OPERATIONFAILED.

설명

이전 버전의 TAPI에서는 이 함수의 구현이 선택 사항이었습니다. TAPI 2.0부터 이 함수의 구현은 모든 서비스 공급자에서 필수입니다. TAPI는 더 이상 Telephon.ini 또는 TAPI 시작 시 레지스트리를 검사하여 서비스 공급자가 지원하는 초기 줄 및 전화 수를 확인하지 않습니다.

TSPI_providerInit 절차를 완료하기 전에 새 디바이스가 나타날 수 있습니다. TAPI는 공급자를 초기화하는 동안 모든 _CREATE 메시지를 올바르게 처리합니다.