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