Fungsi SerCx2CompleteWait (sercx.h)

Artikel
02/29/2024

Metode SerCx2CompleteWait memberi tahu versi 2 dari ekstensi kerangka kerja serial (SerCx2) bahwa peristiwa di masker tunggu saat ini telah terjadi.

Sintaks

void SerCx2CompleteWait(
  [in] WDFDEVICE Device,
  [in] ULONG     Event
);

Parameter

[in] Device

Handel WDFDEVICE ke objek perangkat kerangka kerja yang mewakili pengontrol serial. Driver pengontrol serial membuat objek ini dalam fungsi panggilan balik EvtDriverDeviceAdd . Untuk informasi selengkapnya, lihat SerCx2InitializeDevice.

[in] Event

Jenis peristiwa yang mengakhiri operasi tunggu saat ini. Parameter ini adalah nilai masker tunggu. Setiap jenis peristiwa sesuai dengan bit tertentu di 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

Tidak ada

Keterangan

Ketika SerCx2 menerima permintaan IOCTL_SERIAL_SET_WAIT_MASK dari klien, penangan permintaan di SerCx2 memanggil fungsi panggilan balik EvtSerCx2SetWaitMask untuk memberi tahu driver pengontrol serial bahwa masker tunggu telah berubah.

Ketika peristiwa di masker tunggu baru terjadi, driver memanggil SerCx2CompleteWait untuk memberi tahu SerCx2 tentang peristiwa tersebut. Jika permintaan IOCTL_SERIAL_WAIT_ON_MASK yang dikirim sebelumnya tertunda di SerCx2 pada saat panggilan SerCx2CompleteWait , SerCx2 menyelesaikan permintaan ini dengan masker tunggu output yang menunjukkan peristiwa mana yang terjadi. Jika tidak, SerCx2 menyimpan peristiwa tersebut dalam riwayat peristiwa internalnya untuk mengantisipasi permintaan IOCTL_SERIAL_WAIT_ON_MASK di masa mendatang.