次の方法で共有


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)

こちらもご覧ください

EvtDpcFunc

KDPC

WDF_DPC_CONFIG

WdfDpcCreate