EVT_SERCX_FILECLOSE fungsi panggilan balik (sercx.h)

  • Artikel

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

Lihat juga

EvtSerCxFileCleanup

SerCxInitialize