EVT_SERCX_FILECLOSE fungsi panggilan balik (sercx.h)
Fungsi panggilan balik peristiwa EvtSerCxFileClose memberi tahu driver pengontrol serial bahwa objek file yang mewakili perangkat pengontrol serial telah dirilis.
Sintaks
EVT_SERCX_FILECLOSE EvtSercxFileclose;
void EvtSercxFileclose(
[in] WDFDEVICE Device
)
{...}
Parameter
[in] Device
Handel WDFDEVICE ke objek perangkat kerangka kerja yang mewakili pengontrol serial.
Nilai kembali
Tidak ada
Keterangan
Fungsi ini harus menghapus perangkat pengontrol serial dari status di mana ia siap untuk menerima dan mengirimkan data. Fungsi ini harus menonaktifkan interupsi jika interupsi diaktifkan. Memori apa pun yang dialokasikan hanya untuk masa pakai objek file harus dibatalkan baik dalam fungsi ini atau dalam fungsi EvtSerCxFileCleanup .
Jika driver pengontrol serial mengimplementasikan fungsi EvtSerCxFileCleanup , ekstensi kerangka kerja serial (SerCx) memanggil fungsi ini sebelum memanggil fungsi EvtSerCxFileClose . SerCx memanggil fungsi EvtSerCxFileCleanup ketika klien menutup handel terakhir ke objek file yang mewakili perangkat pengontrol serial. Setelah panggilan ini, driver tidak menerima permintaan baru untuk operasi I/O. SerCx memanggil fungsi EvtSerCxFileClose ketika objek file dirilis, yang terjadi hanya setelah semua permintaan I/O yang luar biasa diselesaikan atau dibatalkan.
Untuk mendaftarkan fungsi panggilan balik EvtSerCxFileClose , driver harus memanggil metode SerCxInitialize .
Untuk informasi selengkapnya, lihat Objek File Kerangka Kerja.
Contoh
Jenis fungsi untuk panggilan balik ini dinyatakan dalam Sercx.h, sebagai berikut.
typedef VOID
EVT_SERCX_FILECLOSE(
__in WDFDEVICE Device
);
Untuk menentukan fungsi panggilan balik EvtSerCxFileClose yang diberi nama MyEvtSerCxFileClose, Anda harus terlebih dahulu memberikan deklarasi fungsi yang diperlukan Pemverifikasi Driver Statis (SDV) dan alat verifikasi lainnya, sebagai berikut.
EVT_SERCX_FILECLOSE MyEvtSerCxFileClose;
Kemudian, terapkan fungsi panggilan balik Anda sebagai berikut.
VOID
MyEvtSerCxFileClose(
__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 |