EVT_SERCX_RECEIVE_CANCEL fungsi panggilan balik (sercx.h)

  • Artikel

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

Lihat juga

SerCxInitialize

SerCxProgressReceive