Fungsi SerCx2SaveReceiveFifoOnD0Exit (sercx.h)

Artikel
10/30/2024

Metode SerCx2SaveReceiveFifoOnD0Exit menginformasikan versi 2 dari 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.

Sintaksis

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 dimuat FIFO.

Mengembalikan nilai

Tidak

Komentar

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 driver EvtDeviceD0Exit atau EvtDeviceD0ExitPreInterruptsDisabled fungsi panggilan balik peristiwa untuk memberi tahu driver untuk menyiapkan pengontrol serial untuk keluar dari status perangkat D0. Sebagai respons, fungsi ini terlebih dahulu mendesak baris siap mengirim (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 driver EvtSerCx2PioReceiveReadBuffer 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 FIFO penerima sebagai persiapan untuk memasuki status 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.