[KMDF にのみ適用]
WdfDpcWdmGetDpc メソッドは、指定されたフレームワーク DPC オブジェクトに関連付けられている KDPC 構造体へのポインターを返します。
構文
PKDPC WdfDpcWdmGetDpc(
[in] WDFDPC Dpc
);
パラメーター
[in] Dpc
フレームワーク DPC オブジェクトへのハンドル。
戻り値
WdfDpcWdmGetDpc は、指定されたフレームワーク DPC オブジェクトに関連付けられている KDPC 構造体へのポインターを返します。
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
注釈
フレームワークベースのドライバーが WdfDpcCreate 呼び出して DPC オブジェクトを作成すると、フレームワークによって KDPC 構造体が作成されます。
ドライバーは、EvtDpcFunc コールバック関数内から WdfDpcWdmGetDpc 呼び出す場合があります。
WdfDpcWdmGetDpc 返すポインターは、フレームワーク DPC オブジェクトが削除されるまで有効です。 ドライバーがフレームワーク DPC オブジェクトの EvtCleanupCallback 関数を提供する場合、ポインターはコールバック関数が返されるまで有効です。
例示
次のコード例では、指定した DPC オブジェクトに関連付けられている KDPC 構造体へのポインターを返します。 WdfDpcCreate コード例は、指定した DPC オブジェクトがどのように作成されたかを示しています。
PKDPC pWdmDpc;
pWdmDpc = WdfDpcWdmGetDpc(PDevExt->CompleteWriteDpc);
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 普遍 |
| 最小 KMDF バージョン | 1.0 |
| ヘッダー | wdfdpc.h (Wdf.h を含む) |
| 図書館 | Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。 |
| IRQL | 任意のレベル |
| DDI コンプライアンス規則 を する | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
こちらもご覧ください
EvtDpcFunc の
KDPC を する