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 |