EVT_SERCX_TRANSMIT_CANCEL fungsi panggilan balik (sercx.h)

Artikel
02/26/2024

Fungsi panggilan balik peristiwa EvtSerCxTransmitCancel memberi tahu driver pengontrol serial bahwa permintaan pengiriman yang tertunda dibatalkan.

Sintaks

EVT_SERCX_TRANSMIT_CANCEL EvtSercxTransmitCancel;

void EvtSercxTransmitCancel(
  [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 pengiriman saat ini telah dibatalkan. Jika driver memiliki operasi pengiriman yang luar biasa yang sedang berlangsung, driver harus membatalkan operasi ini dan memanggil metode SerCxProgressTransmit untuk melaporkan pembatalan. Dalam panggilan SerCxProgressTransmit , atur BytesTransmitted ke jumlah byte yang dikirimkan sebelum operasi dibatalkan, dan atur TransmitStatus ke SerCxStatusCancelled.

Untuk mendaftarkan fungsi panggilan balik EvtSerCxTransmitCancel , driver harus memanggil metode SerCxInitialize .

Contoh

Jenis fungsi untuk panggilan balik ini dinyatakan dalam Sercx.h, sebagai berikut.

typedef VOID
  EVT_SERCX_TRANSMIT_CANCEL(
    __in WDFDEVICE Device
    );

Untuk menentukan fungsi panggilan balik EvtSerCxTransmitCancel yang diberi nama MyEvtSerCxTransmitCancel, Anda harus terlebih dahulu memberikan deklarasi fungsi yang diperlukan Pengverifikasi Driver Statis (SDV) dan alat verifikasi lainnya, sebagai berikut.

EVT_SERCX_TRANSMIT_CANCEL MyEvtSerCxTransmitCancel;

Kemudian, terapkan fungsi panggilan balik Anda sebagai berikut.

VOID
  MyEvtSerCxTransmitCancel(
    __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

Bagikan melalui