Функция 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