WUDF_WORKITEM_FUNCTION Rückruffunktion (wudfworkitem.h)

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

Die OnWorkItem-Ereignisrückruffunktion eines Treibers führt die Arbeit aus, die einem angegebenen Arbeitselement zugeordnet ist.

Syntax

WUDF_WORKITEM_FUNCTION WudfWorkitemFunction;

void WudfWorkitemFunction(
  [in] IWDFWorkItem *pWorkItem
)
{...}

Parameter

[in] pWorkItem

Ein Zeiger auf eine IWDFWorkItem-Schnittstelle .

Rückgabewert

Keine

Bemerkungen

Um eine OnWorkItem-Rückruffunktion zu registrieren, muss ihr Treiber die Adresse der Rückruffunktion in einer WUDF_WORKITEM_CONFIG-Struktur platzieren, bevor IWDFDevice3::CreateWorkItem aufgerufen wird.

In der Regel führt die OnWorkItem-Rückruffunktion eines Treibers Aufgaben aus, die durch Informationen angegeben werden, die der Treiber im Kontextspeicher eines Arbeitselementobjekts gespeichert hat.

Der Treiber darf IWDFObject::D eleteWdfObject nicht über die OnWorkItem-Rückruffunktion aufrufen.

Weitere Informationen finden Sie unter Verwenden von Arbeitselementen.

Beispiele

Der Funktionstyp wird in Wudfworkitem.h wie folgt deklariert.

typedef
VOID
WUDF_WORKITEM_FUNCTION(
    _In_
    IWDFWorkItem* pWorkItem
    );

typedef WUDF_WORKITEM_FUNCTION *PFN_WUDF_WORKITEM;

Um eine OnWorkItem-Rückruffunktion mit dem Namen MyWorkItem zu definieren, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die SDV und andere Überprüfungstools benötigen, wie folgt:

WUDF_WORKITEM_FUNCTION  MyWorkItem;

Implementieren Sie dann Ihre Rückruffunktion wie folgt:

VOID
  MyWorkItem (
   _In_
    IWDFWorkItem* pWorkItem
    )
  {…}

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform	Desktop
UMDF-Mindestversion	1.11
Kopfzeile	wudfworkitem.h

Weitere Informationen

IWDFDevice3::CreateWorkItem

IWDFObject::D eleteWdfObject

WUDF_WORKITEM_CONFIG