Метод 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

Указатель на буфер, получающий указатель на интерфейс 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

См. также раздел

IWDFDevice3

IWDFWorkItem

OnWorkItem

WUDF_WORKITEM_CONFIG

WUDF_WORKITEM_CONFIG_INIT