次の方法で共有

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 で定義されているエラー コードの 1 つを返します。

備考

親オブジェクトを指定した場合、フレームワークは、親オブジェクトが削除されたときに作業項目を自動的に削除します。 または、ドライバー 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