TSPI_lineClose 함수(tspi.h)
TSPI_lineClose 함수는 디바이스에서 미해결 호출 및 비동기 작업을 모두 완료하거나 중단한 후 지정된 열린 선 디바이스를 닫습니다.
구문
LONG TSPIAPI TSPI_lineClose(
HDRVLINE hdLine
);
매개 변수
hdLine
닫을 줄에 대한 서비스 공급자의 핸들입니다. 줄이 성공적으로 닫힌 후에는 이 핸들이 더 이상 유효하지 않습니다.
반환 값
함수가 성공하면 0을 반환하고 오류가 발생하면 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.
LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL.
설명
서비스 공급자는 모든 비동기 작업에 대한 완료를 보고해야 합니다. 미해결 비동기 작업이 있는 줄에 대해 TSPI_lineClose 호출되면 이 프로시저가 반환되기 전에 적절한 결과 또는 오류 코드로 작업이 완료된 것으로 보고됩니다.
회선에서 활성 호출에 에도 비슷한 요구 사항이 있습니다. 적절한 결과 또는 오류 코드로 완료된 미해결 작업을 보고해야 합니다. 필요한 경우 활성 호출도 삭제해야 하며, 이 동작이 LINEDEVCAPS 구조의 LINEDEVCAPFLAGS_CLOSEDROP 비트로 표시된 경우 입니다.
이 프로시저가 반환되면 서비스 공급자는 줄 또는 줄에 있던 호출에 대해 더 이상 htCall 을 보고하지 않아야 합니다. 줄에 대한 서비스 공급자의 핸들과 줄의 호출은 "유효하지 않습니다."가 됩니다.
서비스 공급자는 줄이 열려 있는 동안 예약된 공유 불가능한 리소스를 포기해야 합니다. 예를 들어 comm 포트 및 모뎀을 통해 액세스하는 줄을 닫으면 comm 포트가 닫혀 다른 애플리케이션에서 다시 사용할 수 있게 됩니다.
줄이 닫히고 상태 변경에 더 이상 관심이 없기 때문에 서비스 공급자는 이 함수 호출에 대한 응답으로 LINE_LINEDEVSTATE 메시지를 실행하지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | tspi.h |