Функция WdfWorkItemGetParentObject (wdfworkitem.h)

Статья
02/07/2025

[Применимо к KMDF и UMDF]

Метод WdfWorkItemGetParentObject возвращает объект платформы, с которым связан указанный рабочий элемент.

Синтаксис

WDFOBJECT WdfWorkItemGetParentObject(
  [in] WDFWORKITEM WorkItem
);

Параметры

[in] WorkItem

Дескриптор объекта рабочего элемента платформы, полученный из предыдущего вызова WdfWorkItemCreate.

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

WdfWorkItemGetParentObject возвращает дескриптор объекту платформы, который драйвер, указанный в качестве элемента ParentObject структуры WDF_OBJECT_ATTRIBUTES драйвера, когда драйвер ранее вызывал WdfWorkItemCreate.

Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Замечания

Дополнительные сведения о рабочих элементах см. в разделе Using Framework Work Items.

Примеры

Следующий пример кода — это функция обратного вызова EvtWorkItem из примера драйвера 1394. Пример получает родительский объект устройства рабочего элемента, вызывает определяемую драйвером подпрограмму для обработки рабочего элемента, а затем удаляет объект рабочего элемента.

VOID
t1394_BusResetRoutineWorkItem(
    IN WDFWORKITEM  WorkItem
)
{
    WDFDEVICE  Device = WdfWorkItemGetParentObject(WorkItem);

    t1394_UpdateGenerationCount(Device);

    WdfObjectDelete(WorkItem);
}

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	wdfworkitem.h (include Wdf.h)
библиотеки	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
правил соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

См. также

WDF_OBJECT_ATTRIBUTES

WdfWorkItemCreate

Поделиться через