Fungsi WdfDevicePostEvent (wdfdevice.h)

[Hanya berlaku untuk UMDF]

Metode WdfDevicePostEvent secara asinkron memberi tahu aplikasi yang menunggu peristiwa yang ditentukan dari driver.

Sintaks

NTSTATUS WdfDevicePostEvent(
  [in] WDFDEVICE      Device,
  [in] REFGUID        EventGuid,
  [in] WDF_EVENT_TYPE WdfEventType,
  [in] BYTE           *Data,
  [in] ULONG          DataSizeCb
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] EventGuid

GUID untuk peristiwa tersebut. GUID ditentukan oleh aplikasi dan driver dan buram untuk kerangka kerja.

[in] WdfEventType

Nilai jenis WDF_EVENT_TYPE yang mengidentifikasi jenis peristiwa. Dalam versi UMDF saat ini, driver harus mengatur EventType ke WdfEventBroadcast (1). WdfEventBroadcast menunjukkan bahwa acara disiarkan. Aplikasi dapat berlangganan peristiwa jenis WdfEventBroadcast. Untuk menerima peristiwa siaran, aplikasi harus mendaftar untuk pemberitahuan melalui fungsi Microsoft Win32 RegisterDeviceNotification . Peristiwa jenis WdfEventBroadcast diekspos sebagai peristiwa jenis DBT_CUSTOMEVENT ke aplikasi.

[in] Data

Penunjuk ke buffer yang berisi data yang terkait dengan peristiwa. NULL adalah nilai yang valid.

[in] DataSizeCb

Ukuran, dalam byte, dari data yang menunjuk Data . Nol adalah nilai ukuran yang valid jika Data diatur ke NULL.

Nilai kembali

Jika operasi berhasil, WdfDevicePostEvent mengembalikan STATUS_SUCCESS. Nilai pengembalian tambahan meliputi:

Menampilkan kode	Deskripsi
STATUS_INVALID_PARAMETER	WdfEventType tidak diatur ke WdfEventBroadcast.

 

Metode ini mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Ketika driver memanggil WdfDevicePostEvent untuk memberi tahu aplikasi yang meminta tentang suatu peristiwa, UMDF mengirimkan peristiwa ke sistem operasi. Sistem operasi mengirimkan peristiwa ke aplikasi yang meminta dalam operasi asinkron. Jika sistem operasi awalnya tidak mengembalikan kesalahan, WdfDevicePostEvent mengembalikan STATUS_SUCCESS.

Namun, nantinya, jika sistem operasi menerima kesalahan saat mencoba mengirimkan peristiwa (mungkin karena kondisi memori yang rendah), sistem operasi tidak dapat memberi tahu driver tentang kesalahan tersebut. Karena sifat asinkron dari pemberitahuan peristiwa ini, pengiriman peristiwa ke aplikasi yang meminta tidak dijamin.

Jika informasi peristiwa hilang dalam perjalanan hingga aplikasi yang meminta, aplikasi harus dapat pulih dari peristiwa yang hilang.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1
Target Platform	Universal
Versi UMDF minimum	2.0
Header	wdfdevice.h (termasuk Wdf.h)
Pustaka	WUDFx02000.lib
DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

Lihat juga

IWDFDevice::P ostEvent

WDF_EVENT_TYPE