IWDFDevice3::CreateWorkItem-Methode (wudfddi.h)

Artikel
02/27/2024

[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