UrsReportHardwareEvent-Funktion (ursdevice.h)

  • Artikel

Benachrichtigt die USB-Dual-Role-Klassenerweiterung über ein neues Hardwareereignis.

Syntax

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

Parameter

[in] Device

Ein Handle für das Framework-Geräteobjekt, das der Clienttreiber im vorherigen Aufruf von WdfDeviceCreate abgerufen hat.

[in] HardwareEvent

Ein URS_HARDWARE_EVENT-Typwert, der den Typ des aufgetretenen Ereignisses angibt.

Rückgabewert

Keine

Bemerkungen

Bevor Hardwareereignisse gemeldet werden, muss der Clienttreiber für den Controller mit zwei Rollen der Klassenerweiterung durch Aufrufen von UrsSetHardwareEventSupport angeben, dass der Treiber Hardwareereignisse unterstützt.

Der Clienttreiber kann UrsHardwareEventNone nicht als HardwareEvent-Parameterwert übergeben. Dieser Wert ist für die interne Verwendung reserviert.

Der Clienttreiber muss diese Methode aufrufen, um Hardwareereignisse wie z. B. ID-Pin-Interrupts zu melden. In der Regel liest der Treiber in der Implementierung des EvtInterruptIsr-Rückrufs den ID-Pin-Zustand und meldet das Ereignis an die Klassenerweiterung, indem er diese Methode aufruft.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10
Unterstützte Mindestversion (Server) Windows Server 2016
Zielplattform Windows
KMDF-Mindestversion 1.15
Kopfzeile ursdevice.h (include Urscx.h)
Bibliothek Urscxstub.lib
IRQL HIGH_LEVEL

Weitere Informationen