Fungsi UrsReportHardwareEvent (ursdevice.h)

  • Artikel

Memberi tahu ekstensi kelas peran ganda USB tentang peristiwa perangkat keras baru.

Sintaks

void UrsReportHardwareEvent(
  [in] WDFDEVICE          Device,
  [in] URS_HARDWARE_EVENT HardwareEvent
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja yang diambil driver klien dalam panggilan sebelumnya ke WdfDeviceCreate.

[in] HardwareEvent

Nilai jenis URS_HARDWARE_EVENT yang menunjukkan jenis peristiwa yang terjadi.

Nilai kembali

Tidak ada

Keterangan

Sebelum melaporkan peristiwa perangkat keras apa pun, driver klien untuk pengontrol peran ganda harus menunjukkan ke ekstensi kelas bahwa driver mendukung peristiwa perangkat keras dengan memanggil UrsSetHardwareEventSupport.

Driver klien tidak dapat meneruskan UrsHardwareEventNone sebagai nilai parameter HardwareEvent . Nilai tersebut dicadangkan untuk penggunaan internal.

Driver klien harus memanggil metode ini untuk melaporkan peristiwa perangkat keras apa pun, seperti gangguan pin ID. Biasanya, dalam implementasi driver dari panggilan balik EvtInterruptIsr , driver membaca status ID-pin dan melaporkan peristiwa ke ekstensi kelas dengan memanggil metode ini.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10
Server minimum yang didukung Server Windows 2016
Target Platform Windows
Versi KMDF minimum 1.15
Header ursdevice.h (termasuk Urscx.h)
Pustaka Urscxstub.lib
IRQL HIGH_LEVEL

Lihat juga