WdfDpcWdmGetDpc 関数 (wdfdpc.h)
[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 |
| Header | wdfdpc.h (Wdf.h を含む) |
| Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
| IRQL | 任意のレベル |
| DDI コンプライアンス規則 | DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf) |