TSPI_providerEnumDevices 함수(tspi.h)
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 메시지를 올바르게 처리합니다.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | Windows |
헤더 | tspi.h |