WdfDpcEnqueue 函数 (wdfdpc.h)
[仅适用于 KMDF]
WdfDpcEnqueue 方法计划执行 DPC 对象的 EvtDpcFunc 回调函数。
语法
BOOLEAN WdfDpcEnqueue(
[in] WDFDPC Dpc
);
参数
[in] Dpc
框架 DPC 对象的句柄。
返回值
如果 WdfDpcEnqueue 成功将指定的 DPC 对象添加到系统的 DPC 队列，则它返回 TRUE。 否则， 方法返回 FALSE。
如果驱动程序提供无效的对象句柄，则会发生 bug 检查。
注解
WdfDpcEnqueue 方法将指定的 DPC 对象添加到系统的 DPC 队列（如果尚未在队列中）。 (如果 DPC 对象已在队列中，则该方法返回 FALSE.) 当系统未执行高优先级任务时，它会从队列中删除 DPC 对象并调用对象的 EvtDpcFunc 回调函数。
回调函数执行后，对 WdfDpcEnqueue 的后续调用会将 DPC 对象添加回 DPC 队列。
有关使用 DPC 对象的详细信息，请参阅 维护中断。
示例
下面的代码示例计划执行与 DPC 对象关联的回调函数。 该示例使用 WdfDpcEnqueue 方法的返回值作为包含函数的返回值。 WdfDpcCreate 代码示例演示如何创建 DPC 对象。
return WdfDpcEnqueue(PDevExt->CompleteWriteDpc);
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 通用 |
| 最低 KMDF 版本 | 1.0 |
| 标头 | wdfdpc.h (包括 Wdf.h) |
| Library | Wdf01000.sys (请参阅框架库版本控制.) |
| IRQL | 任何级别 |
| DDI 符合性规则 | DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf) |