Fungsi SerCx2PioReceiveReady (sercx.h)

Artikel
10/30/2024

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

Sintaksis

void SerCx2PioReceiveReady(
  [in] SERCX2PIORECEIVE PioReceive
);

Parameter

[in] PioReceive

Handel SERCX2PIORECEIVE ke objek penerima PIO. Driver pengontrol serial sebelumnya disebut metode SerCx2PioReceiveCreate untuk membuat objek ini.

Mengembalikan nilai

Tidak

Komentar

Untuk memulai transaksi penerimaan PIO, SerCx2 memanggil fungsi panggilan balik peristiwa EvtSerCx2PioReceiveReadBuffer dan menyediakan buffer baca untuk mentransfer data dari FIFO penerima di pengontrol serial. Jika nilai pengembalian dari fungsi ini menunjukkan bahwa buffer baca hanya diisi sebagian sebelum FIFO penerima menjadi kosong, SerCx2 memanggil EvtSerCx2PioReceiveEnableReadyNotification rutinitas panggilan balik peristiwa untuk mengaktifkan pemberitahuan siap terjadi ketika lebih banyak data tersedia untuk dibaca.

Jika pemberitahuan siap diaktifkan dan lebih banyak data tersedia untuk dibaca, driver pengontrol serial harus memanggil SerCx2PioReceiveReady untuk memberi tahu SerCx2. Menanggapi pemberitahuan ini, SerCx2 memanggil fungsi EvtSerCx2PioReceiveReadBuffer untuk mentransfer lebih banyak data dari FIFO penerima ke buffer baca.

Driver pengontrol serial harus memanggil SerCx2PioReceiveReady hanya sebagai respons terhadap panggilan ke fungsi EvtSerCx2PioReceiveEnableReadyNotification.

Selain itu, SerCx2 menggunakan pemberitahuan siap ini untuk mendeteksi batas waktu interval selama penanganan permintaan baca. Untuk informasi selengkapnya tentang batas waktu interval, lihat SERIAL_TIMEOUTS. Untuk informasi selengkapnya tentang pemberitahuan siap, lihat Transaksi PIO-Receive SerCx2 .