Fungsi SerCx2SystemDmaReceiveNewDataNotification (sercx.h)

Artikel
08/07/2023

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

Sintaks

void SerCx2SystemDmaReceiveNewDataNotification(
  [in] SERCX2SYSTEMDMARECEIVE SystemDmaReceive
);

Parameter

[in] SystemDmaReceive

Handel SERCX2SYSTEMDMARECEIVE ke objek yang diterima DMA sistem. Driver pengontrol serial sebelumnya disebut metode SerCx2SystemDmaReceiveCreate untuk membuat objek ini.

Nilai kembali

Tidak ada

Keterangan

Jika MENERIMA FIFO dalam pengontrol serial menjadi kosong sebelum transaksi penerimaan DMA sistem dapat diselesaikan, SerCx2 memanggil fungsi panggilan balik peristiwa EvtSerCx2SystemDmaReceiveEnableNewDataNotification , jika diimplementasikan, untuk memungkinkan SerCx2 menerima pemberitahuan data baru ketika data kembali tersedia untuk dibaca dari FIFO penerima.

Jika pemberitahuan data baru diaktifkan, driver pengontrol serial harus memanggil SerCx2SystemDmaReceiveNewDataNotification untuk memberi tahu SerCx2 setelah pengontrol serial menerima data baru. Pemberitahuan terjadi ketika driver mendeteksi bahwa satu atau beberapa byte baru dari data yang diterima siap untuk ditransfer atau telah ditransfer oleh pengontrol DMA sistem.

Pengontrol serial harus memanggil SerCx2SystemDmaReceiveNewDataNotification hanya sebagai respons terhadap panggilan ke fungsi EvtSerCx2SystemDmaReceiveEnableNewDataNotification .

Jika driver pengontrol serial mendukung pemberitahuan data baru untuk transaksi yang diterima DMA sistem, 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 Transaksi SerCx2 System-DMA-Receive.