lineDevSpecific 함수(tapi.h)

아티클
08/26/2023

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 메시지를 사용해야 합니다.

서비스 공급자는 이 함수에 사용할 매개 변수를 정의하여 디바이스별 함수에 대한 액세스를 제공할 수 있습니다. 이러한 디바이스별 확장을 사용하려는 애플리케이션은 정의된 확장을 설명하는 디바이스별(이 경우 공급업체별) 설명서를 참조해야 합니다. 일반적으로 이러한 디바이스별 확장을 사용하는 애플리케이션은 다른 서비스 공급자 환경에서 작업할 수 없습니다.

주의 TAPI는 LINE_REPLY 메시지가 반환될 때 lParam에서 참조하는 버퍼에 반환된 데이터를 씁니다. 즉, LINE_REPLY 메시지가 반환될 때까지 버퍼가 유효한 상태를 유지해야 합니다. 그렇지 않으면 데이터 손상 및 예외가 발생할 수 있습니다.