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. 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 CreateWorkItem--Methode erstellt ein Framework-Arbeitselementobjekt, das anschließend der Arbeitsaufgabenwarteschlange 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 bereits initialisiert haben muss, indem WUDF_WORKITEM_CONFIG_INITaufgerufen wird.
[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.
Bemerkungen
Wenn Sie ein übergeordnetes Objekt angeben, löscht das Framework automatisch die Arbeitsaufgabe, wenn das übergeordnete Objekt gelöscht wird. Alternativ kann der Treiber IWDFObject::D eleteWdfObject aufrufen, um eine Arbeitsaufgabe 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 |
| Mindest-UMDF-Version | 1.11 |
| Header- | wudfddi.h |
| DLL- | WUDFx.dll |