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) |