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

[Относится к KMDF и UMDF]

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

Синтаксис

WDFOBJECT WdfWorkItemGetParentObject(
  [in] WDFWORKITEM WorkItem
);

Параметры

[in] WorkItem

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

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

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

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

Комментарии

Дополнительные сведения о рабочих элементах см. в разделе Использование рабочих элементов платформы.

Примеры

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

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

    t1394_UpdateGenerationCount(Device);

    WdfObjectDelete(WorkItem);
}

Требования

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

WDF_OBJECT_ATTRIBUTES

WdfWorkItemCreate