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

추가 정보

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneNegotiateExtVersion