WDF_DPC_CONFIG 结构 (wdfdpc.h)

[仅适用于 KMDF]

WDF_DPC_CONFIG 结构包含 DPC 对象的配置信息。

语法

typedef struct _WDF_DPC_CONFIG {
  ULONG       Size;
  PFN_WDF_DPC EvtDpcFunc;
  BOOLEAN     AutomaticSerialization;
} WDF_DPC_CONFIG, *PWDF_DPC_CONFIG;

成员

Size

此结构的大小(以字节为单位)。

EvtDpcFunc

指向驱动程序的 EvtDpcFunc 回调函数的指针。

AutomaticSerialization

一个布尔值,如果 为 TRUE,则指示框架会将 DPC 对象的 EvtDpcFunc 回调函数的执行与来自 DPC 对象父对象下的其他对象的回调函数同步。 有关更多信息,请参见下面的“备注”部分。

注解

WDF_DPC_CONFIG结构用作 WdfDpcCreate 的输入。

若要初始化 WDF_DPC_CONFIG 结构,驱动程序应首先调用 WDF_DPC_CONFIG_INIT ,然后填充 WDF_DPC_CONFIG_INIT 未初始化的结构成员。

如果将父设备对象的同步范围设置为 WdfSynchronizationScopeNone,则将 AutomaticSerialization 设置为 TRUE 不起作用。

如果父设备对象的执行级别设置为 WdfExecutionLevelPassive,则将 AutomaticSerialization 设置为 TRUE 会导致 WdfDpcCreate 失败。

有关 自动序列化 和同步驱动程序回调函数的详细信息,请参阅 用于 Framework-Based 驱动程序的同步技术

有关在基于框架的驱动程序中处理中断的详细信息,请参阅 处理硬件中断

要求

要求
最低 KMDF 版本 1.0
标头 wdfdpc.h (包括 Wdf.h)

另请参阅

EvtDpcFunc

KDPC

WDF_DPC_CONFIG_INIT

WdfDpcCreate