SerCx2CustomReceiveTransactionReportProgress 함수(sercx.h)
SerCx2CustomReceiveTransactionReportProgress 메서드는 현재 사용자 지정 수신 트랜잭션을 완료하기 위한 진행 상황을 보고합니다.
통사론
void SerCx2CustomReceiveTransactionReportProgress(
SERCX2CUSTOMRECEIVETRANSACTION CustomReceiveTransaction,
[in] SERCX2_CUSTOM_RECEIVE_TRANSACTION_PROGRESS Progress
);
매개 변수
CustomReceiveTransaction
사용자 지정 수신 개체에 대한 SERCX2CUSTOMRECEIVETRANSACTION 핸들입니다. 이전에 SerCx2CustomReceiveTransactionCreate 메서드를 호출한 직렬 컨트롤러 드라이버는 이 개체를 만듭니다.
[in] Progress
사용자 지정 수신 트랜잭션을 완료하기 위한 진행 여부입니다. 이 매개 변수를 다음 열거형 상수 중 하나로 설정합니다.
- SERCX2_CUSTOM_RECEIVE_NO_PROGRESS
- SERCX2_CUSTOM_RECEIVE_BYTES_TRANSFERRED
반환 값
없음
발언
직렬 컨트롤러가 현재 사용자 지정 수신 트랜잭션을 완료하는 방향으로 진행 중인지 여부를 확인하기 위해 SerCx2는 주기적으로 EvtSerCx2CustomReceiveTransactionQueryProgress 이벤트 콜백 함수를 호출합니다. 이 호출에 대한 응답으로 직렬 컨트롤러 드라이버는 SerCx2CustomReceiveTransactionReportProgress 호출하여 진행률 보고서를 제공합니다.
각 SerCx2CustomReceiveTransactionReportProgress 호출은 이 메서드에 대한 이전 호출 또는 트랜잭션의 시작 이후 현재 사용자 지정 수신 트랜잭션에서 데이터 바이트가 전송되었는지 여부를 보고합니다. 하나 이상의 바이트가 전송된 경우 호출은 직렬 컨트롤러가 진행 중임을 보고합니다. 바이트가 전송되지 않은 경우 호출은 진행률이 없다고 보고합니다.
직렬 컨트롤러 드라이버는 SerCx2에서 EvtSerCx2CustomReceiveTransactionQueryProgress 함수로의 호출에 대한 응답으로만 이 메서드를 호출해야 합니다.
자세한 내용은 SerCx2 Custom-Receive 트랜잭션참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8.1 시작해서 사용할 수 있습니다. |
| 대상 플랫폼 | 보편적 |
| 헤더 | sercx.h |
| IRQL |
<= DISPATCH_LEVEL |
참고 항목
EvtSerCx2CustomReceiveTransactionQueryProgress
SERCX2CUSTOMRECEIVETRANSACTION