Fungsi SerCxCompleteWait (sercx.h)

Artikel
08/07/2023

Metode SerCxCompleteWait memberi tahu ekstensi kerangka kerja serial (SerCx) bahwa peristiwa di masker tunggu saat ini telah terjadi.

Sintaks

NTSTATUS SerCxCompleteWait(
  [in] WDFDEVICE Device,
  [in] ULONG     Event
);

Parameter

[in] Device

Handel WDFDEVICE ke objek perangkat kerangka kerja yang mewakili pengontrol serial.

[in] Event

Jenis peristiwa yang mengakhiri operasi tunggu saat ini. Parameter ini adalah nilai masker tunggu. Setiap jenis peristiwa sesuai dengan bit tertentu dalam masker tunggu. Bit ini diatur untuk menunjukkan bahwa peristiwa yang sesuai telah terjadi. Untuk informasi selengkapnya tentang jenis peristiwa yang dapat ditentukan oleh masker tunggu, lihat SERIAL_EV_XXX.

Nilai kembali

SerCxCompleteWait mengembalikan STATUS_SUCCESS jika panggilan berhasil. Kemungkinan nilai pengembalian kesalahan menyertakan kode status berikut.

Menampilkan kode	Deskripsi
STATUS_INVALID_PARAMETER	Peristiwa yang ditentukan tidak disertakan dalam masker tunggu saat ini.

Keterangan

Ketika SerCx menerima permintaan IOCTL_SERIAL_SET_WAIT_MASK dari klien, penangan permintaan di SerCx memanggil fungsi panggilan balik EvtSerCxWaitmask untuk memberi tahu driver pengontrol serial bahwa masker tunggu telah berubah. Masker tunggu menentukan serangkaian peristiwa perangkat keras untuk dipantau oleh pengontrol serial. Selama panggilan ini, driver membuang masker tunggu lama yang mungkin telah ditentukan dalam panggilan EvtSerCxWaitmask sebelumnya, dan kemudian mengonfigurasi perangkat keras pengontrol serial untuk mendeteksi peristiwa di masker tunggu baru.

Kemudian, ketika peristiwa di masker tunggu baru terjadi, driver memanggil SerCxCompleteWait untuk memberi tahu SerCx tentang peristiwa tersebut. Jika permintaan IOCTL_SERIAL_WAIT_ON_MASK yang dikirim sebelumnya tertunda, SerCxCompleteWait menyelesaikan permintaan ini dengan status STATUS_SUCCESS dan masker tunggu output yang menunjukkan peristiwa mana yang terjadi. Jika tidak, SerCxCompleteWait menyimpan peristiwa tersebut dalam riwayat peristiwa internalnya untuk mengantisipasi permintaan IOCTL_SERIAL_WAIT_ON_MASK di masa mendatang.