WdfDpcEnqueue 関数 (wdfdpc.h)
[KMDF にのみ適用]
WdfDpcEnqueue メソッドは、DPC オブジェクトの EvtDpcFunc コールバック関数の実行をスケジュールします。
構文
BOOLEAN WdfDpcEnqueue(
[in] WDFDPC Dpc
);
パラメーター
[in] Dpc
フレームワーク DPC オブジェクトへのハンドル。
戻り値
WdfDpcEnqueue は、指定された DPC オブジェクトをシステムの DPC キューに正常に追加した場合に TRUE を 返します。 それ以外の場合、メソッドは FALSE を返します。
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
注釈
WdfDpcEnqueue メソッドは、指定された DPC オブジェクトをシステムの DPC キューに追加します (まだキューに存在しない場合)。 (DPC オブジェクトが既にキューに存在していた場合、メソッドは FALSE を返します)。システムが優先度の高いタスクを実行していない場合は、キューから DPC オブジェクトを削除し、オブジェクトの EvtDpcFunc コールバック関数を呼び出します。
コールバック関数が実行されると、 後続の WdfDpcEnqueue の呼び出しによって DPC オブジェクトが DPC キューに追加されます。
DPC オブジェクトの使用の詳細については、「 割り込みのサービス」を参照してください。
例
次のコード例では、DPC オブジェクトに関連付けられているコールバック関数の実行をスケジュールします。 この例では、 WdfDpcEnqueue メソッドの戻り値を含む関数の戻り値として使用します。 WdfDpcCreate コード例は、DPC オブジェクトがどのように作成されたかを示しています。
return WdfDpcEnqueue(PDevExt->CompleteWriteDpc);
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| Header | wdfdpc.h (Wdf.h を含む) |
| Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
| IRQL | 任意のレベル |
| DDI コンプライアンス規則 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |