TSPI_lineDevSpecific 함수(tspi.h)
TSPI_lineDevSpecific 함수는 서비스 공급자가 다른 작업에 설명되지 않은 기능에 대한 액세스를 제공할 수 있도록 하는 일반적인 확장 메커니즘으로 사용됩니다. 확장의 의미는 디바이스별이며 이러한 확장을 활용하려면 애플리케이션이 이를 완전히 인식해야 합니다.
구문
LONG TSPIAPI TSPI_lineDevSpecific(
DRV_REQUESTID dwRequestID,
HDRVLINE hdLine,
DWORD dwAddressID,
HDRVCALL hdCall,
LPVOID lpParams,
DWORD dwSize
);
매개 변수
dwRequestID
비동기 요청의 식별자입니다.
hdLine
작동할 줄에 대한 서비스 공급자의 핸들입니다.
dwAddressID
작동할 지정된 줄의 주소입니다. 주소 식별자는 주소와 영구적으로 연결됩니다. 식별자는 운영 체제 업그레이드에서 일정하게 유지됩니다.
hdCall
작동할 호출에 대한 서비스 공급자의 핸들입니다. 이 필드에는 NULL 값이 있을 수 있습니다. hdCall의 호출 상태는 디바이스별로 다릅니다.
lpParams
매개 변수 블록을 보유하는 데 사용되는 메모리 영역에 대한 포인터입니다. 이 매개 변수 블록의 형식은 디바이스별로 다릅니다.
dwSize
매개 변수 블록 영역의 크기(바이트)입니다. lpParams 매개 변수가 문자열에 대한 포인터인 경우 크기는 null 종결자를 포함해야 합니다.
반환 값
오류가 발생하면 dwRequestID 또는 오류 번호를 반환합니다. 함수가 성공하면 해당 ASYNC_COMPLETIONlResult 실제 매개 변수는 0이거나 오류가 발생할 경우 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.
LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
설명
추가 반환 값은 디바이스별로 다릅니다.
이 작업은 제네릭 매개 변수 프로필을 제공합니다. 매개 변수 구조의 해석은 디바이스별로 다릅니다. TAPI는 항상 hdLine 매개 변수를 지정합니다. dwAddressID 및/또는 hdCall이 유효한지 여부는 디바이스별로 다릅니다. 지정된 경우 hdLine에 속해야 합니다. 디바이스별 애플리케이션으로 다시 전송된 표시 및 회신은 LINE_DEVSPECIFIC 메시지를 사용합니다.
이 함수는 TAPI 함수 lineDevSpecific을 호출하는 애플리케이션에 대한 직접 응답에서 호출됩니다. TAPI는 TAPI 수준에서 사용되는 hLine 및 hdCall 매개 변수를 TSPI 수준에서 사용되는 해당 hdLine 및 hdCall 매개 변수로 변환합니다. lpParams 버퍼는 수정되지 않은 상태로 전달됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | tspi.h |