Метод IWDFDevice3::CreateWorkItem (wudfddi.h)

Статья
08/08/2023

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы 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

Указатель на буфер, получающий указатель на интерфейс IWDFWorkItem для нового объекта WorkItem.

Возвращаемое значение

При успешном выполнении операции метод возвращает 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