EVT_SERCX_RECEIVE_CANCEL fungsi panggilan balik (sercx.h)
Fungsi panggilan balik peristiwa EvtSerCxReceiveCancel memberi tahu driver pengontrol serial bahwa permintaan terima yang tertunda dibatalkan.
Sintaks
EVT_SERCX_RECEIVE_CANCEL EvtSercxReceiveCancel;
void EvtSercxReceiveCancel(
[in] WDFDEVICE Device
)
{...}
Parameter
[in] Device
Handel WDFDEVICE ke objek perangkat kerangka kerja yang mewakili pengontrol serial.
Nilai kembali
Tidak ada
Keterangan
Ekstensi kerangka kerja serial (SerCx) memanggil fungsi ini untuk memberi tahu driver pengontrol serial bahwa permintaan terima saat ini telah dibatalkan. Jika driver memiliki operasi penerimaan yang luar biasa yang sedang berlangsung, driver harus membatalkan operasi ini dan memanggil metode SerCxProgressReceive untuk melaporkan pembatalan. Dalam panggilan SerCxProgressReceive , atur BytesReceived ke jumlah byte yang diterima sebelum operasi dibatalkan, dan atur ReceiveStatus ke SerCxStatusCancelled.
Untuk mendaftarkan fungsi panggilan balik EvtSerCxReceiveCancel , driver harus memanggil metode SerCxInitialize .
Contoh
Jenis fungsi untuk panggilan balik ini dinyatakan dalam Sercx.h, sebagai berikut.
typedef VOID
EVT_SERCX_RECEIVE_CANCEL(
__in WDFDEVICE Device
);
Untuk menentukan fungsi panggilan balik EvtSerCxReceiveCancel yang diberi nama MyEvtSerCxReceiveCancel, Anda harus terlebih dahulu memberikan deklarasi fungsi yang diperlukan Pemverifikasi Driver Statis (SDV) dan alat verifikasi lainnya, sebagai berikut.
EVT_SERCX_RECEIVE_CANCEL MyEvtSerCxReceiveCancel;
Kemudian, terapkan fungsi panggilan balik Anda sebagai berikut.
VOID
MyEvtSerCxReceiveCancel(
__in WDFDEVICE Device
)
{ ... }
Untuk informasi selengkapnya tentang persyaratan SDV untuk deklarasi fungsi, lihat Mendeklarasikan Fungsi Menggunakan Jenis Peran Fungsi untuk Driver KMDF.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia dimulai dengan Windows 8. |
| Target Platform | Desktop |
| Header | sercx.h |
| IRQL | Dipanggil di IRQL <= DISPATCH_LEVEL |