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
ヘッダー 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