TSPI_phoneNegotiateTSPIVersion 함수(tspi.h)

  • 아티클

TSPI_phoneNegotiateTSPIVersion 함수는 가능한 SPI 버전의 범위를 감안할 때 서비스 공급자가 이 디바이스에 대해 작동할 수 있는 가장 높은 SPI 버전을 반환합니다.

구문

LONG TSPIAPI TSPI_phoneNegotiateTSPIVersion(
  DWORD   dwDeviceID,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwTSPIVersion
);

매개 변수

dwDeviceID

인터페이스 버전 협상을 수행할 휴대폰 디바이스입니다. 허용되는 값은 이 서비스 공급자의 전화 장치 식별자 범위 내에 엄격하게 포함됩니다. INITIALIZE_NEGOTIATION 값은 이 함수에 전달되지 않습니다.

dwLowVersion

TAPI가 작동할 수 있는 가장 낮은 TSPI 버전 번호입니다. 가장 중요한 WORD 는 주 버전 번호이고 가장 중요한 WORD 는 부 버전 번호입니다.

dwHighVersion

TAPI가 작동할 수 있는 가장 높은 TSPI 버전 번호입니다. 가장 중요한 WORD 는 주 버전 번호이고 가장 중요한 WORD 는 부 버전 번호입니다.

lpdwTSPIVersion

DWORD에 대한 포인터입니다. 이 함수에서 성공적으로 반환되면 서비스 공급자는 서비스 공급자가 작동할 수 있는 호출자가 요청한 범위 내에서 가장 높은 TSPI 버전 번호로 이 위치를 채웁니다. 가장 중요한 WORD 는 주 버전 번호이고 가장 중요한 WORD 는 부 버전 번호입니다. 요청된 범위가 서비스 공급자가 지원하는 범위와 겹치지 않으면 함수는 PHONEERR_INCOMPATIBLEAPIVERSION 반환합니다.

반환 값

함수가 성공하면 0을 반환하고 오류가 발생하면 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.

PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.

설명

작업을 사용할 수 없는 경우 서비스 공급자는 PHONEERR_OPERATIONUNAVAIL 반환합니다. 그러나 서비스 공급자가 전화 디바이스를 지원하는 경우 이 기능도 지원해야 하며 함수는 PHONEERR_OPERATIONUNAVAIL 반환하지 않아야 합니다.

TAPI는 각 휴대폰 디바이스에 대한 초기화 시퀀스 초기에 이 함수를 호출합니다.

확장 버전의 협상은 별도의 프로시저 TSPI_phoneNegotiateExtVersion 통해 수행됩니다.

TAPI 수준의 해당 함수는 서비스 공급자가 지원하는 확장 식별자(있는 경우)도 검색하는 오버로드된 함수입니다. TSPI 수준에서 확장 식별자 검색은 별도의 프로시저, 즉 TSPI_phoneGetExtensionID 통해 수행됩니다.

요구 사항

   
대상 플랫폼 Windows
헤더 tspi.h

추가 정보

INITIALIZE_NEGOTIATION

TSPI_phoneGetExtensionID

TSPI_phoneNegotiateExtVersion