TSPI_lineNegotiateTSPIVersion 함수(tspi.h)

아티클
03/06/2024

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

구문

LONG TSPIAPI TSPI_lineNegotiateTSPIVersion(
  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 는 부 버전 번호입니다. 요청된 범위가 서비스 공급자가 지원하는 범위와 겹치지 않으면 함수는 LINEERR_INCOMPATIBLEAPIVERSION 반환합니다.

반환 값

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

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

설명

dwDeviceID가 INITIALIZE_NEGOTIATION 경우 서비스 공급자가 줄 디바이스를 지원하지 않더라도 전체 인터페이스 버전을 협상하기 위해 이 함수(해당 값 포함)가 필수이므로 이 함수는 LINEERR_OPERATIONUNAVAIL 반환하지 않아야 합니다.