Fungsi SerCx2CustomReceiveTransactionReportProgress (sercx.h)

Artikel
02/29/2024

Metode SerCx2CustomReceiveTransactionReportProgress melaporkan apakah kemajuan sedang dibuat untuk menyelesaikan transaksi penerimaan kustom saat ini.

Sintaks

void SerCx2CustomReceiveTransactionReportProgress(
       SERCX2CUSTOMRECEIVETRANSACTION             CustomReceiveTransaction,
  [in] SERCX2_CUSTOM_RECEIVE_TRANSACTION_PROGRESS Progress
);

Parameter

CustomReceiveTransaction

Handel SERCX2CUSTOMRECEIVETRANSACTION ke objek penerima kustom. Driver pengontrol serial sebelumnya disebut metode SerCx2CustomReceiveTransactionCreate untuk membuat objek ini.

[in] Progress

Apakah kemajuan sedang dibuat untuk menyelesaikan transaksi penerima kustom. Atur parameter ini ke salah satu konstanta enumerasi berikut:

SERCX2_CUSTOM_RECEIVE_NO_PROGRESS
SERCX2_CUSTOM_RECEIVE_BYTES_TRANSFERRED

Untuk informasi selengkapnya tentang konstanta enumerasi ini, lihat SERCX2_CUSTOM_RECEIVE_TRANSACTION_PROGRESS.

Nilai kembali

Tidak ada

Keterangan

Untuk menentukan apakah pengontrol serial mengalami kemajuan dalam menyelesaikan transaksi penerimaan kustom saat ini, SerCx2 secara berkala memanggil fungsi panggilan balik peristiwa EvtSerCx2CustomReceiveTransactionQueryProgress . Menanggapi panggilan ini, driver pengontrol serial memanggil SerCx2CustomReceiveTransactionReportProgress untuk memberikan laporan kemajuan.

Setiap panggilan SerCx2CustomReceiveTransactionReportProgress melaporkan apakah ada byte data yang telah ditransfer dalam transaksi penerimaan kustom saat ini karena panggilan sebelumnya ke metode ini atau awal transaksi, mana yang lebih baru. Jika satu atau beberapa byte telah ditransfer, panggilan melaporkan bahwa pengontrol serial mengalami kemajuan. Jika tidak ada byte yang ditransfer, panggilan melaporkan bahwa tidak ada kemajuan.

Driver pengontrol serial harus memanggil metode ini hanya sebagai respons terhadap panggilan dari SerCx2 ke fungsi EvtSerCx2CustomReceiveTransactionQueryProgress .

Untuk informasi selengkapnya, lihat Transaksi Custom-Receive SerCx2.