TSPI_phoneGetDevCaps 함수(tspi.h)
TSPI_phoneGetDevCaps 함수는 지정된 전화 장치를 쿼리하여 전화 통신 기능을 확인합니다.
구문
LONG TSPIAPI TSPI_phoneGetDevCaps(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwExtVersion,
LPPHONECAPS lpPhoneCaps
);
매개 변수
dwDeviceID
쿼리할 휴대폰 디바이스입니다.
dwTSPIVersion
협상된 TSPI 버전 번호입니다. 이 값은 TSPI_phoneNegotiateTSPIVersion 함수를 통해 이 디바이스에 대해 협상됩니다.
dwExtVersion
협상된 확장 버전 번호입니다. 이 값은 TSPI_phoneNegotiateExtVersion 함수를 통해 이 디바이스에 대해 협상됩니다.
lpPhoneCaps
서비스 공급자가 PHONECAPS 형식의 고정 크기 구조를 작성하는 메모리에 대한 포인터입니다. 요청이 성공적으로 완료되면 이 구조는 전화 장치 기능 정보로 채워집니다. TSPI_phoneGetDevCaps 호출하기 전에 애플리케이션은 이 구조체의 dwTotalSize 멤버를 설정하여 정보를 반환하는 데 TAPI에 사용할 수 있는 메모리 양을 나타냅니다.
반환 값
함수가 성공하면 0을 반환하고 오류가 발생하면 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.
PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NODRIVER, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
설명
서비스 공급자는 TAPI로 채워진 dwTotalSize를 제외하고 PHONEBUTTONINFO 데이터 구조의 모든 멤버를 채웁니다. 서비스 공급자는 dwTotalSize 멤버를 덮어쓰지 않아야 합니다.
dwExtVersion이 0이면 확장 정보가 요청되지 않습니다. 0이 아닌 경우 TSPI_phoneNegotiateExtVersion 함수를 사용하여 이 디바이스에 대해 이미 협상된 값을 보유합니다. 서비스 공급자는 지정된 확장 버전에 따라 디바이스 및 공급업체별 확장 정보를 채웁니다.
서비스 공급자가 TSPI_phoneGetDevCaps 함수에서 반환되면 TAPI는 PHONECAPS 구조의 dwPhoneStates 멤버를 다음과 같이 설정합니다.
PHONECAPS.dwPhoneStates |=
PHONESTATE_OWNER |
PHONESTATE_MONITORS |
PHONESTATE_REINIT;
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | tspi.h |