EVT_SERCX_FILEOPEN fungsi panggilan balik (sercx.h)
Fungsi panggilan balik peristiwa EvtSerCxFileOpen memberi tahu driver pengontrol serial bahwa klien membuka handel file pada perangkat pengontrol serial dan bahwa objek file telah dibuat untuk mewakili perangkat.
Sintaks
EVT_SERCX_FILEOPEN EvtSercxFileopen;
NTSTATUS EvtSercxFileopen(
[in] WDFDEVICE Device
)
{...}
Parameter
[in] Device
Handel WDFDEVICE ke objek perangkat kerangka kerja yang mewakili pengontrol serial.
Nilai kembali
Fungsi EvtSerCxFileOpen mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika tidak, kode status kesalahan akan ditampilkan.
Keterangan
Ekstensi kerangka kerja serial (SerCx) memanggil fungsi ini untuk menyiapkan perangkat keras pengontrol serial untuk menerima permintaan operasi I/O. Fungsi ini harus mengonfigurasi pengontrol dalam keadaan di mana ia siap untuk menerima dan mengirimkan data. Jika interupsi diperlukan, fungsi ini harus mengaktifkan interupsi. Selain itu, fungsi ini harus mengalokasikan memori apa pun yang diperlukan hanya selama masa pakai objek file. Misalnya, fungsi ini dapat mengalokasikan buffer data interupsi.
Untuk mendaftarkan fungsi panggilan balik EvtSerCxFileOpen , 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 NTSTATUS
EVT_SERCX_FILEOPEN(
__in WDFDEVICE Device
);
Untuk menentukan fungsi panggilan balik EvtSerCxFileOpen yang diberi nama MyEvtSerCxFileOpen, Anda harus terlebih dahulu memberikan deklarasi fungsi yang diperlukan Pemverifikasi Driver Statis (SDV) dan alat verifikasi lainnya, sebagai berikut.
EVT_SERCX_FILEOPEN MyEvtSerCxFileOpen;
Kemudian, terapkan fungsi panggilan balik Anda sebagai berikut.
NTSTATUS
MyEvtSerCxFileOpen(
__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 |