SerCx2SaveReceiveFifoOnD0Exit (sercx.h)

Artikel
02/26/2024

Metode SerCx2SaveReceiveFifoOnD0Exit menginformasikan versi 2 ekstensi kerangka kerja serial (SerCx2) bahwa FIFO penerima perangkat keras pengontrol serial berisi data yang harus disimpan sebelum pengontrol serial memasuki status daya rendah perangkat.

Sintaks

void SerCx2SaveReceiveFifoOnD0Exit(
  [in] SERCX2PIORECEIVE PioReceive,
  [in] ULONG            FifoSize
);

Parameter

[in] PioReceive

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

[in] FifoSize

Jumlah byte data yang belum dibaca yang dikandung FIFO.

Nilai kembali

Tidak ada

Keterangan

Ketika pengontrol serial akan memasuki status berdaya rendah, SerCx2 dan driver pengontrol serial harus menyimpan byte data yang belum dibaca yang mungkin tetap berada di FIFO penerima. Jika tidak, data ini akan hilang ketika pengontrol serial memasuki status daya rendah. Untuk meminta bantuan dari SerCx2 untuk menyimpan data ini, driver memanggil SerCx2SaveReceiveFifoOnD0Exit.

Kerangka kerja driver memanggil fungsi panggilan balik peristiwa EvtDeviceD0Exit atau EvtDeviceD0ExitPreInterruptsDisabled driver untuk memberi tahu driver untuk menyiapkan pengontrol serial untuk keluar dari status perangkat D0. Sebagai tanggapan, fungsi ini terlebih dahulu mendeassert baris siap dikirim (RTS) untuk memberi tahu perangkat di ujung lain koneksi serial untuk tidak mengirim data lagi. Selanjutnya, fungsi memanggil SerCx2SaveReceiveFifoOnD0Exit.

SerCx2SaveReceiveFifoOnD0Exit memanggil fungsi panggilan balik peristiwa EvtSerCx2PioReceiveReadBuffer driver untuk mengambil data dari FIFO penerima. Dalam panggilan ini, SerCx2 memasok, sebagai parameter, penunjuk ke buffer perangkat lunak internal yang dikelola SerCx2 untuk tujuan menyimpan data yang belum dibaca dari MENERIMA FIFO sebagai persiapan untuk memasuki keadaan berdaya rendah.

Kemudian, setelah klien mengirim permintaan baca (IRP_MJ_READ) ke pengontrol serial, SerCx2 menyalin byte dari buffer perangkat lunak internal ini ke buffer baca dalam permintaan.