IWDFDevice3：：CreateWorkItem 方法 (wudfddi.h)

發行項
02/27/2024

[警告： UMDF 2 是最新版的 UMDF，並取代 UMDF 1。所有新的UMDF驅動程式都應該使用UMDF 2撰寫。未將新功能新增至 UMDF 1，且較新版本的 #DA85CEB9F841C47369D0F8C58B7EAE185 上，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);