IWDFDevice3：：CreateWorkItem 方法 (wudfddi.h)

项目
02/27/2024

[警告： UMDF 2 是最新版本的 UMDF，取代了 UMDF 1。所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。未向 UMDF 1 添加新功能，并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。通用 Windows 驱动程序必须使用 UMDF 2。有关详细信息，请参阅使用 UMDF 入门。]

CreateWorkItem 方法创建框架工作项对象，该对象随后可添加到框架的工作项队列中。

语法

HRESULT CreateWorkItem(
  [in]           PWUDF_WORKITEM_CONFIG pConfig,
  [in, optional] IWDFObject            *pParentObject,
  [out]          IWDFWorkItem          **ppWorkItem
);

参数

[in] pConfig

指向调用方分配 WUDF_WORKITEM_CONFIG 结构的指针，驱动程序必须已通过调用 WUDF_WORKITEM_CONFIG_INIT对其进行初始化。

[in, optional] pParentObject

指向父对象接口或 NULL 的指针。

[out] ppWorkItem

指向缓冲区的指针，该缓冲区接收指向新 WorkItem 对象的 IWDFWorkItem 接口的指针。

返回值

如果操作成功，该方法将返回S_OK。否则，此方法返回 Winerror.h 中定义的错误代码之一。

注解

如果指定父对象，框架会在删除父对象时自动删除工作项。或者，驱动程序可以调用 IWDFObject：:D eleteWdfObject 来删除工作项。驱动程序不得删除其 OnWorkItem 回调函数中的工作项。

有关详细信息，请参阅使用工作项。

示例

WUDF_WORKITEM_CONFIG config;
        
WUDF_WORKITEM_CONFIG_INIT(&config, OnWorkItem); 
hr = m_IWdfDevice3->CreateWorkItem(&config,
                                   m_IWdfDevice3,   
                                   &m_WorkItem);