Метод IWDFDevice3::CreateWorkItem (wudfddi.h)
[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]
Метод CreateWorkItem создает объект work-item платформы, который впоследствии можно добавить в очередь рабочих элементов платформы.
Синтаксис
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 для удаления рабочего элемента. Драйвер не должен удалять рабочий элемент в функции обратного вызова OnWorkIte m.
Дополнительные сведения см. в разделе Использование рабочих элементов.
Примеры
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 |