IWDFDevice3::CreateWorkItem メソッド (wudfddi.h)

[アーティクル]
03/05/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);

要件

要件	値
サポート終了	UMDF 2.0 以降では使用できません。
対象プラットフォーム	デスクトップ
最小 UMDF バージョン	1.11
Header	wudfddi.h
[DLL]	WUDFx.dll