lineDevSpecificFeature 함수(tapi.h)

아티클
03/05/2024

lineDevSpecificFeature 함수를 사용하면 서비스 공급자가 다른 TAPI 함수에서 제공하지 않는 기능에 대한 액세스를 제공할 수 있습니다. 이러한 확장의 의미는 디바이스에 따라 다릅니다. 이러한 확장을 활용하려면 애플리케이션에서 이를 완전히 인식해야 합니다.

구문

LONG lineDevSpecificFeature(
  HLINE  hLine,
  DWORD  dwFeature,
  LPVOID lpParams,
  DWORD  dwSize
);

매개 변수

hLine

줄 디바이스에 대한 핸들입니다.

dwFeature

줄 디바이스에서 호출하는 기능입니다. 이 매개 변수는 PHONEBUTTONFUNCTION_ 상수를 사용합니다.

lpParams

기능 종속 매개 변수 블록을 보유하는 데 사용되는 메모리 영역에 대한 포인터입니다. 이 매개 변수 블록의 형식은 디바이스별이며 해당 콘텐츠는 TAPI에서 서비스 공급자에게 전달됩니다.

dwSize

버퍼의 크기(바이트)입니다.

반환 값

함수가 비동기적으로 완료된 경우 양수 요청 식별자를 반환하거나 오류가 발생할 경우 음수 오류 번호를 반환합니다. 함수가 성공하면 해당 LINE_REPLY 메시지의 dwParam2 매개 변수가 0이거나 오류가 발생하면 음수 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.

LINEERR_INVALFEATURE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

추가 반환 값은 디바이스별 값입니다.

설명

이 작업은 확장 전화 통신 서비스의 일부입니다. 해당 의미를 정의하지 않고 디바이스별 기능에 액세스할 수 있습니다. 이 작업은 애플리케이션이 디바이스별 확장 버전을 성공적으로 협상한 경우에만 사용할 수 있습니다.

이 함수는 휴대폰 기능 단추 에뮬레이션 기능을 애플리케이션에 제공합니다. 애플리케이션이 이 작업을 호출할 때 단추 누르기 이벤트에 해당하는 를 지정합니다. TAPI는 해당 의미를 정의하지 않으므로 기능을 호출하는 이 메서드는 디바이스에 따라 다릅니다. 일반적으로 이러한 디바이스별 확장을 사용하는 애플리케이션은 다른 서비스 공급자 환경에서 작동하지 않습니다.

32비트 버전의 TAPI에서 16비트 애플리케이션을 실행할 때 제대로 변환(unked)되지 않으므로 lpParams 에서 가리키는 구조에는 포인터가 포함되어서는 안 됩니다.