phoneGetDevCaps 함수(tapi.h)
phoneGetDevCaps 함수는 지정된 전화 장치를 쿼리하여 전화 통신 기능을 확인합니다.
구문
LONG phoneGetDevCaps(
HPHONEAPP hPhoneApp,
DWORD dwDeviceID,
DWORD dwAPIVersion,
DWORD dwExtVersion,
LPPHONECAPS lpPhoneCaps
);
매개 변수
hPhoneApp
TAPI를 사용하여 애플리케이션 등록을 처리합니다.
dwDeviceID
쿼리할 휴대폰 디바이스의 식별자입니다.
dwAPIVersion
사용할 전화 통신 API의 버전 번호입니다. 상위 단어에는 주 버전 번호가 포함됩니다. 하위 단어에는 부 버전 번호가 포함됩니다. 이 번호는 함수 phoneNegotiateAPIVersion을 사용하여 가져옵니다.
dwExtVersion
사용할 서비스 공급자별 확장의 버전 번호입니다. 이 번호는 함수 phoneNegotiateExtVersion을 사용하여 가져옵니다. 디바이스별 확장을 사용하지 않는 경우 0으로 둘 수 있습니다. 그렇지 않으면 상위 단어에 주 버전 번호가 포함됩니다. 하위 단어에는 부 버전 번호가 포함됩니다.
lpPhoneCaps
PHONECAPS 형식의 고정 크기 구조체에 대한 포인터입니다. 요청이 성공적으로 완료되면 이 구조는 전화 장치 기능 정보로 채워집니다.
반환 값
요청이 성공하면 0을 반환하고 오류가 발생하면 음수 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.
PHONEERR_INVALAPPHANDLE, PHONEERR_INVALPOINTER, PHONEERR_BADDEVICEID, PHONEERR_OPERATIONFAILED, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_NOMEM, PHONEERR_STRUCTURETOOSMALL, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.
설명
phoneGetDevCaps를 사용하기 전에 애플리케이션은 사용할 TAPI 버전 번호(phoneNegotiateAPIVersion 참조) 및 필요에 따라 사용할 확장 버전(phoneNegotiateExtVersion 참조)을 협상해야 합니다.
TAPI 및 확장 버전 번호는 TAPI, 전화 통신 DLL 및 서비스 공급자가 작동해야 하는 번호입니다. 버전 범위가 겹치지 않으면 애플리케이션 및 API 또는 서비스 공급자 버전이 호환되지 않고 오류가 반환됩니다.
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | tapi.h |
| 라이브러리 | Tapi32.lib |
| DLL | Tapi32.dll |