WUDF_INTERRUPT_WORKITEM Rückruffunktion (wudfinterrupt.h)

Artikel
02/07/2025

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]

Die OnInterruptWorkItem eines Treibers Ereignisrückruffunktion verarbeitet Informationen, die die OnInterruptIsr Rückruffunktion des Treibers gespeichert haben.

Syntax

WUDF_INTERRUPT_WORKITEM WudfInterruptWorkitem;

void WudfInterruptWorkitem(
  [in] IWDFInterrupt *Interrupt,
  [in] IWDFObject *AssociatedObject
)
{...}

Parameter

[in] Interrupt

Ein Zeiger auf die interrupt-Objektschnittstelle, die der Arbeitsaufgabe zugeordnet ist.

[in] AssociatedObject

Ein Zeiger auf das zugeordnete Objekt.

Rückgabewert

Nichts

Bemerkungen

Um eine OnInterruptWorkItem- Rückruffunktion zu registrieren, muss Der Treiber die Adresse der Rückruffunktion in einer WUDF_INTERRUPT_CONFIG-Struktur platzieren, bevor IWDFDevice3::CreateInterruptaufgerufen wird.

Nach dem Beenden und Bestätigen des Interrupts sollte der Treiber schnell von seinem OnInterruptIsr- Rückruf zurückkehren, wobei alle zusätzlichen Verarbeitungen auf ein OnInterruptWorkItem- Rückruf zurückgehalten werden.

Weitere Informationen zum Behandeln von Unterbrechungen in UMDF-Treibern finden Sie unter Zugreifen auf Hardware und Behandeln von Interrupts.

Beispiele

Der Funktionstyp wird wie folgt in Wudfworkitem.hdeklariert.

typedef
_Function_class_(WUDF_INTERRUPT_WORKITEM)
VOID
WUDF_INTERRUPT_WORKITEM(
    _In_
    IWDFInterrupt* Interrupt,
    _In_
    IWDFObject* AssociatedObject
    );

typedef WUDF_INTERRUPT_WORKITEM *PFN_WUDF_INTERRUPT_WORKITEM;

Um eine OnInterruptWorkItem- Rückruffunktion zu definieren, die MyInterruptWorkItem-heißt, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die SDV und andere Überprüfungstools erfordern:

WUDF_INTERRUPT_WORKITEM  MyInterruptWorkItem;

Implementieren Sie dann die Rückruffunktion wie folgt:

VOID
  MyInterruptWorkItem (
    _In_
    IWDFInterrupt* Interrupt,
    _In_
    IWDFObject* AssociatedObject
    )
  {…}

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform-	Desktop
Mindest-UMDF-Version	1.11
Header-	wudfinterrupt.h

Siehe auch

IWDFDevice3::CreateInterrupt

WUDF_INTERRUPT_CONFIG

Freigeben über