lineDevSpecific 함수(tapi.h)
lineDevSpecific 함수를 사용하면 서비스 공급자가 다른 TAPI 함수에서 제공하지 않는 기능에 대한 액세스를 제공할 수 있습니다. 확장의 의미는 디바이스별로 다릅니다. 이러한 확장을 활용하려면 애플리케이션에서 이를 완전히 인식해야 합니다.
구문
LONG lineDevSpecific(
HLINE hLine,
DWORD dwAddressID,
HCALL hCall,
LPVOID lpParams,
DWORD dwSize
);
매개 변수
hLine
줄 디바이스에 대한 핸들입니다. 이 매개 변수는 필수입니다.
dwAddressID
지정된 줄 디바이스의 주소 식별자입니다. 주소 식별자는 주소와 영구적으로 연결됩니다. 식별자는 운영 체제 업그레이드에서 일정하게 유지됩니다.
hCall
호출에 대한 핸들입니다. 이 매개 변수는 선택 사항이지만 지정된 경우 해당 매개 변수가 나타내는 호출이 hLine 줄 디바이스에 속해야 합니다. hCall의 호출 상태는 디바이스별로 다릅니다.
lpParams
매개 변수 블록을 보유하는 데 사용되는 메모리 영역에 대한 포인터입니다. 이 매개 변수 블록의 형식은 디바이스별로 지정되며 해당 콘텐츠는 TAPI에서 서비스 공급자에게 전달됩니다.
dwSize
매개 변수 블록 영역의 크기(바이트)입니다.
반환 값
함수가 비동기적으로 완료된 경우 양수 요청 식별자를 반환하거나 오류가 발생할 경우 음수 오류 번호를 반환합니다. 함수가 성공하면 해당 LINE_REPLY 메시지의 dwParam2 매개 변수가 0이거나 오류가 발생하면 음수 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.
LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.
추가 반환 값은 디바이스별로 다릅니다.
설명
이 작업은 확장 전화 통신 서비스의 일부입니다. 의미를 정의하지 않고 디바이스별 기능에 액세스할 수 있습니다. 이 작업은 애플리케이션이 디바이스별 확장 버전을 성공적으로 협상한 경우에만 사용할 수 있습니다.
이 함수는 제네릭 매개 변수 프로필을 제공합니다. 매개 변수 구조의 해석은 디바이스별로 다릅니다. dwAddressID 및/또는 hCall이 유효한지 여부는 디바이스별로 다릅니다. 지정된 경우 hLine에 속해야 합니다. 디바이스별 애플리케이션을 다시 보낸 표시 및 회신은 LINE_DEVSPECIFIC 메시지를 사용해야 합니다.
서비스 공급자는 이 함수에 사용할 매개 변수를 정의하여 디바이스별 함수에 대한 액세스를 제공할 수 있습니다. 이러한 디바이스별 확장을 사용하려는 애플리케이션은 정의된 확장을 설명하는 디바이스별(이 경우 공급업체별) 설명서를 참조해야 합니다. 일반적으로 이러한 디바이스별 확장을 사용하는 애플리케이션은 다른 서비스 공급자 환경에서 작업할 수 없습니다.
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | tapi.h |
| 라이브러리 | Tapi32.lib |
| DLL | Tapi32.dll |