IWDFDevice3::CreateWorkItem-Methode (wudfddi.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 CreateWorkItem-Methode erstellt ein Framework-Arbeitselementobjekt, das anschließend der Arbeitselementwarteschlange des Frameworks hinzugefügt werden kann.
Syntax
HRESULT CreateWorkItem(
[in] PWUDF_WORKITEM_CONFIG pConfig,
[in, optional] IWDFObject *pParentObject,
[out] IWDFWorkItem **ppWorkItem
);
Parameter
[in] pConfig
Ein Zeiger auf eine vom Aufrufer zugewiesene WUDF_WORKITEM_CONFIG Struktur, die der Treiber durch Aufrufen WUDF_WORKITEM_CONFIG_INIT bereits initialisiert haben muss.
[in, optional] pParentObject
Ein Zeiger auf die übergeordnete Objektschnittstelle oder NULL.
[out] ppWorkItem
Ein Zeiger auf einen Puffer, der einen Zeiger auf die IWDFWorkItem-Schnittstelle für das neue WorkItem-Objekt empfängt.
Rückgabewert
Die -Methode gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind.
Hinweise
Wenn Sie ein übergeordnetes Objekt angeben, löscht das Framework das Arbeitselement automatisch, wenn das übergeordnete Objekt gelöscht wird. Alternativ kann der Treiber IWDFObject::D eleteWdfObject aufrufen, um ein Arbeitselement zu löschen. Der Treiber darf ein Arbeitselement in seiner OnWorkItem-Rückruffunktion nicht löschen.
Weitere Informationen finden Sie unter Verwenden von Arbeitselementen.
Beispiele
WUDF_WORKITEM_CONFIG config;
WUDF_WORKITEM_CONFIG_INIT(&config, OnWorkItem);
hr = m_IWdfDevice3->CreateWorkItem(&config,
m_IWdfDevice3,
&m_WorkItem);
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.11 |
| Kopfzeile | wudfddi.h |
| DLL | WUDFx.dll |