WdfWorkItemGetParentObject 関数 (wdfworkitem.h)

[KMDF と UMDF に適用]

WdfWorkItemGetParentObject メソッドは、指定した作業項目が関連付けられているフレームワーク オブジェクトを返します。

構文

WDFOBJECT WdfWorkItemGetParentObject(
  [in] WDFWORKITEM WorkItem
);

パラメーター

[in] WorkItem

WdfWorkItemCreate の以前の呼び出しから取得されたフレームワーク作業項目オブジェクトへのハンドル。

戻り値

WdfWorkItemGetParentObject は、ドライバーが以前に WdfWorkItemCreate を呼び出したときに、ドライバーがドライバーのWDF_OBJECT_ATTRIBUTES構造体の ParentObject メンバーとして指定したフレームワーク オブジェクトへのハンドルを返します。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

注釈

作業項目の詳細については、「フレームワーク作業項目の 使用」を参照してください。

次のコード例は、1394 サンプル ドライバーからの EvtWorkItem コールバック関数です。 この例では、作業項目の親デバイス オブジェクトを取得し、ドライバー定義ルーチンを呼び出して作業項目を処理した後、作業項目オブジェクトを削除します。

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

    t1394_UpdateGenerationCount(Device);

    WdfObjectDelete(WorkItem);
}

要件

要件
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
最小 UMDF バージョン 2.0
Header wdfworkitem.h (Wdf.h を含む)
Library Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 DriverCreate(kmdf)KmdfIrql(kmdf)KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)

こちらもご覧ください

WDF_OBJECT_ATTRIBUTES

WdfWorkItemCreate