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)