共用方式為


IWDFDevice3::CreateWorkItem 方法 (wudfddi.h)

[警告: 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);

要求

要求 價值
終止支援 UMDF 2.0 和更新版本中無法使用。
目標平臺 桌面
最低 UMDF 版本 1.11
標頭 wudfddi.h
DLL WUDFx.dll

另請參閱

IWDFDevice3

IWDFWorkItem

OnWorkItem

WUDF_WORKITEM_CONFIG

WUDF_WORKITEM_CONFIG_INIT