phoneGetDevCapsA 함수(tapi.h)

phoneGetDevCaps 함수는 지정된 휴대폰 디바이스를 쿼리하여 전화 통신 기능을 확인합니다.

통사론

LONG phoneGetDevCapsA(
  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 또는 서비스 공급자 버전이 호환되지 않으며 오류가 반환됩니다.

메모

tapi.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 phoneGetDevCaps를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구	값
대상 플랫폼	Windows
헤더	tapi.h
라이브러리	Tapi32.lib
DLL	Tapi32.dll

참고 항목

PHONECAPS

추가 전화 서비스 함수

TAPI 2.2 참조 개요

phoneNegotiateAPIVersion

phoneNegotiateExtVersion