SerCx2CustomReceiveTransactionNewDataNotification (sercx.h)

Artikel
03/05/2024

Metode SerCx2CustomReceiveTransactionNewDataNotification memberi tahu versi 2 dari ekstensi kerangka kerja serial (SerCx2) bahwa data tersedia untuk dibaca dari FIFO penerima di perangkat keras pengontrol serial.

Sintaks

void SerCx2CustomReceiveTransactionNewDataNotification(
  [in] SERCX2CUSTOMRECEIVETRANSACTION CustomReceiveTransaction
);

Parameter

[in] CustomReceiveTransaction

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

Nilai kembali

Tidak ada

Keterangan

Jika MENERIMA FIFO di pengontrol serial menjadi kosong sebelum transaksi penerimaan kustom dapat diselesaikan, SerCx2 memanggil fungsi panggilan balik peristiwa EvtSerCx2CustomReceiveTransactionEnableNewDataNotification , jika diimplementasikan, untuk mengaktifkan pemberitahuan data baru terjadi ketika data baru tersedia untuk dibaca dari FIFO penerima.

Jika pemberitahuan data baru diaktifkan dan data baru tersedia untuk dibaca, driver pengontrol serial harus memanggil SerCx2CustomReceiveTransactionNewDataNotification untuk memberi tahu SerCx2. Pemberitahuan ini terjadi ketika driver mendeteksi bahwa satu atau beberapa byte baru dari data yang diterima siap untuk ditransfer oleh mekanisme transfer data kustom atau telah ditransfer oleh mekanisme ini.

Driver pengontrol serial harus memanggil SerCx2CustomReceiveTransactionNewDataNotification hanya sebagai respons terhadap panggilan ke fungsi EvtSerCx2CustomReceiveTransactionEnableNewDataNotification .

Jika driver pengontrol serial mendukung pemberitahuan data baru untuk transaksi penerimaan kustom, SerCx menggunakan pemberitahuan ini untuk mendeteksi batas waktu interval selama penanganan permintaan baca (IRP_MJ_READ). Untuk informasi selengkapnya tentang batas waktu interval, lihat SERIAL_TIMEOUTS. Untuk informasi selengkapnya tentang pemberitahuan data baru, lihat SerCx2 Custom-Receive Transaksi.