TSPI_lineSetStatusMessages 함수(tspi.h)

아티클
03/03/2024

TSPI_lineSetStatusMessages 함수를 사용하면 TAPI가 지정된 줄 또는 주소에 대한 변경 내용과 관련된 이벤트에 대해 서비스 공급자가 생성해야 하는 알림 메시지를 지정할 수 상태.

구문

LONG TSPIAPI TSPI_lineSetStatusMessages(
  HDRVLINE hdLine,
  DWORD    dwLineStates,
  DWORD    dwAddressStates
);

매개 변수

hdLine

새 필터를 설정할 줄 디바이스에 대한 핸들입니다.

dwLineStates

메시지를 변경하는 줄 디바이스 상태 나타내는 비트 배열은 TAPI로 전송됩니다. 이 매개 변수는 LINEDEVSTATE_ 상수 중 하나를 사용합니다.

dwAddressStates

메시지를 변경할 상태 주소를 식별하는 비트 배열은 TAPI로 전송됩니다. 이 매개 변수는 LINEADDRESSSTATE_ 상수 중 하나를 사용합니다.

반환 값

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

LINEERR_INVALADDRESSSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINESTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.

설명

dwLineStates 매개 변수에 LINEDEVSTATE_ 상수가 아닌 하나 이상의 비트가 포함된 경우 서비스 공급자는 LINEERR_INVALLINESTATE 반환합니다.

전화 통신은 줄과 주소에서 발생하는 이벤트에 대해 애플리케이션에 알리는 여러 메시지를 정의합니다. 모든 애플리케이션에 관심이 있는 모든 변경 메시지 집합은 가능한 메시지 집합보다 훨씬 작을 수 있습니다. 이 절차를 통해 TAPI는 서비스 공급자에게 배달할 메시지의 축소된 집합을 알릴 수 있습니다. 서비스 공급자는 지정된 집합 내에서 지원하는 모든 메시지를 전달합니다. 더 많은 것을 제공할 수 있지만(TAPI에 의해 필터링됨) 성능상의 이유로 이를 수행하지 않는 것이 좋습니다. TAPI가 공급자가 생성하지 않은 특정 메시지 형식의 배달을 요청하는 경우 공급자는 요청을 수락하지만 메시지를 생성하지는 않습니다. 기본적으로 주소 및 줄 상태 보고는 처음에 줄에 대해 사용하지 않도록 설정됩니다.

이 함수는 다음과 같이 해당 TAPI 함수와 다릅니다. (1) 요청된 메시지 집합은 TAPI 수준에서 애플리케이션이 요청한 모든 집합의 합합입니다. (2) 메시지 집합은 소유권에 의해 축소되거나 보강되지 않습니다(TSPI 수준에 소유권 개념이 없기 때문)(3) 집합은 서비스 공급자가 적어도 표시된 메시지 집합을 전달해야 하지만 더 큰 집합을 전달할 수 있다는 점에서 권고입니다.

TSPI 수준에서 한 번에 하나의 미해결 Open만 있기 때문에 열기 및 닫기와 관련된 디바이스 상태 변경 내용은 보고되지 않습니다.