TSPI_lineDevSpecificFeature 함수(tspi.h)
TSPI_lineDevSpecificFeature 함수는 서비스 공급자가 다른 작업에 설명되지 않은 기능에 대한 액세스를 제공할 수 있도록 하는 확장 메커니즘으로 사용됩니다. 이러한 확장의 의미는 디바이스에 따라 다릅니다. 이러한 확장을 활용하려면 TAPI 또는 해당 클라이언트 애플리케이션이 이를 완전히 인식해야 합니다.
구문
LONG TSPIAPI TSPI_lineDevSpecificFeature(
DRV_REQUESTID dwRequestID,
HDRVLINE hdLine,
DWORD dwFeature,
LPVOID lpParams,
DWORD dwSize
);
매개 변수
dwRequestID
비동기 요청의 식별자입니다.
hdLine
라인 디바이스에 대한 서비스 공급자의 핸들입니다.
dwFeature
줄 디바이스에서 호출할 기능입니다. 이 매개 변수는 PHONEBUTTONFUNCTION_ 상수를 사용합니다.
lpParams
기능 종속 매개 변수 블록을 보유하는 데 사용되는 메모리 영역에 대한 포인터입니다. 이 매개 변수 블록의 형식은 디바이스에 따라 다릅니다.
dwSize
버퍼 크기(바이트)입니다. lpParams 매개 변수가 문자열에 대한 포인터인 경우 크기는 null 종결자를 포함해야 합니다.
반환 값
오류가 발생하면 dwRequestID 또는 오류 번호를 반환합니다. 해당 ASYNC_COMPLETIONlResult 실제 매개 변수는 함수가 성공하면 0이거나 오류가 발생하면 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.
LINEERR_INVALFEATURE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
설명
추가 반환 값은 디바이스별 값입니다. hdCall의 호출 상태는 디바이스에 따라 다릅니다.
이 함수는 TAPI 애플리케이션에 전화 기능 단추 에뮬레이션 기능을 제공합니다. TAPI는 클라이언트 애플리케이션을 대신하여 이 작업을 호출할 때 "단추 누르기" 이벤트에 해당하는 를 지정합니다. 기능을 호출하는 이 메서드는 API가 해당 의미를 정의하지 않으므로 디바이스에 따라 크게 달라집니다. 애플리케이션이 디바이스별 확장을 사용하는 경우 애플리케이션은 다른 서비스 공급자 환경으로 잘 이식되지 않습니다.
이 함수는 TAPI lineDevSpecificFeature 함수를 호출하는 애플리케이션에 대한 직접 응답에서 호출됩니다. TAPI는 TAPI 수준에서 사용되는 hLine 매개 변수를 TSPI 수준에서 사용되는 해당 hdLine 매개 변수로 변환합니다. lpParams 버퍼는 수정되지 않은 상태로 전달됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | tspi.h |