Fungsi SerCx2PioReceiveReady (sercx.h)

Artikel
02/29/2024

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

Sintaks

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 ada

Keterangan

Untuk memulai transaksi penerima PIO, SerCx2 memanggil fungsi panggilan balik peristiwa EvtSerCx2PioReceiveReadBuffer dan memasok buffer baca untuk mentransfer data dari FIFO penerima di pengontrol serial. Jika nilai yang dikembalikan dari fungsi ini menunjukkan bahwa buffer baca hanya diisi sebagian sebelum FIFO penerima menjadi kosong, SerCx2 memanggil rutin panggilan balik peristiwa EvtSerCx2PioReceiveEnableReadyNotification untuk memungkinkan 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 lagi 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 SerCx2 PIO-Receive Transaksi.