UrsReportHardwareEvent 函式 (ursdevice.h)

通知 USB 雙重角色類別延伸模組有關新的硬體事件。

語法

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

[in] Device

用戶端驅動程式在先前呼叫 WdfDeviceCreate 中所擷取之架構裝置物件的句柄。

[in] HardwareEvent

URS_HARDWARE_EVENT型別值，指出發生的事件類型。

無

在報告任何硬體事件之前，雙角色控制器的用戶端驅動程序必須透過呼叫 UrsSetHardwareEventSupport 向類別延伸模組指出驅動程式支援硬體事件。

用戶端驅動程序無法傳遞 UrsHardwareEventNone 作為 HardwareEvent 參數值。該值會保留供內部使用。

用戶端驅動程序必須呼叫這個方法來報告任何硬體事件，例如ID針腳中斷。一般而言，在驅動程序實作 EvtInterruptIsr 回呼中，驅動程式會讀取 ID-pin 狀態，並藉由呼叫這個方法向類別延伸模塊報告事件。