共用方式為

WdfWorkItemGetParentObject 函式 （wdfworkitem.h）

  • 發行項

[適用於 KMDF 和 UMDF]

WdfWorkItemGetParentObject 方法會傳回與指定工作專案相關聯的架構物件。

語法

WDFOBJECT WdfWorkItemGetParentObject(
  [in] WDFWORKITEM WorkItem
);

參數

[in] WorkItem

從先前呼叫 WdfWorkItemCreate取得之架構工作項目物件的句柄。

傳回值

WdfWorkItemGetParentObject 會傳回驅動程式指定為驅動程式 ParentObject 成員的 Framework 物件的句柄，該驅動程式先前呼叫 WdfWorkItemCreate時， 驅動程式的 WDF_OBJECT_ATTRIBUTES 成員。

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

言論

如需工作項目的詳細資訊，請參閱使用 Framework 工作專案 。

例子

下列程式代碼範例是來自 1394 範例驅動程式的 EvtWorkItem 回呼函式。 此範例會取得工作專案的父裝置物件、呼叫驅動程式定義的例程來處理工作專案，然後刪除工作項目物件。

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

    t1394_UpdateGenerationCount(Device);

    WdfObjectDelete(WorkItem);
}

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
標頭 wdfworkitem.h （包括 Wdf.h）
連結庫 Wdf01000.sys （KMDF）：WUDFx02000.dll （UMDF）
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf）

另請參閱

WDF_OBJECT_ATTRIBUTES

WdfWorkItemCreate