Fungsi PosCxPutPendingEvent (poscx.h)

Artikel
02/26/2024

PosCxPutPendingEvent membuat objek peristiwa baru, menyalin data peristiwa ke objek peristiwa baru, dan mencoba mendelegasikannya ke pemanggil tunggu. Jika penelepon target tidak memiliki permintaan baca yang menunggu, peristiwa baru ditambahkan ke antrean peristiwa yang ditunjuk (kontrol atau data).

Sintaks

NTSTATUS PosCxPutPendingEvent(
  [in] WDFDEVICE               device,
  [in] ULONG                   deviceInterfaceTag,
  [in] ULONG                   eventType,
  [in] size_t                  rawEventDataSize,
       PVOID                   rawEventDataPtr,
  [in] POS_CX_EVENT_ATTRIBUTES eventAttr
);

Parameter

[in] device

Handel ke objek perangkat kerangka kerja yang mewakili perangkat.

[in] deviceInterfaceTag

Antarmuka perangkat yang terkait dengan peristiwa. Secara default, hanya objek file yang memiliki tag yang sama yang akan menerima kejadian ini.

[in] eventType

Jenis peristiwa baru.

[in] rawEventDataSize

Ukuran buffer peristiwa mentah (tanpa header titik layanan) dalam byte.

rawEventDataPtr

Penunjuk ke data peristiwa mentah (tanpa header titik layanan). Pemanggil dapat menggunakan kembali/merilis rawEventDataPtr setelah PosCxPutPendingEvent kembali.

[in] eventAttr

Atribut peristiwa.

Mengembalikan nilai

Nilai yang mungkin dikembalikan adalah:

Nilai	Deskripsi
STATUS_SUCCESS	Peristiwa dibuat dan didelegasikan ke penelepon tunggu, atau peristiwa dibuang karena tidak ada pemilik perangkat.
STATUS_PENDING	Kejadian ini diantrekan karena saat ini tidak ada penelepon yang menunggu.
Kesalahan lainnya	Kode kesalahan kegagalan lain yang sesuai.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	poscx.h (termasuk Poscx.h)

Lihat juga

POS_CX_EVENT_ATTRIBUTES

Bagikan melalui