WDF_DRIVER_CONFIG结构 (wdfdriver.h)
[适用于 KMDF 和 UMDF]
WDF_DRIVER_CONFIG结构是 WdfDriverCreate的输入参数。
语法
typedef struct _WDF_DRIVER_CONFIG {
ULONG Size;
PFN_WDF_DRIVER_DEVICE_ADD EvtDriverDeviceAdd;
PFN_WDF_DRIVER_UNLOAD EvtDriverUnload;
ULONG DriverInitFlags;
ULONG DriverPoolTag;
} WDF_DRIVER_CONFIG, *PWDF_DRIVER_CONFIG;
成员
Size
此结构的大小(以字节为单位)。
EvtDriverDeviceAdd
指向驱动程序 EvtDriverDeviceAdd 回调函数的指针。
EvtDriverUnload
指向驱动程序 EvtDriverUnload 回调函数的指针。
DriverInitFlags
标识驱动程序初始化标志的一个或多个 WDF_DRIVER_INIT_FLAGS类型的值的按位 OR。
DriverPoolTag
(KMDF 版本 1.5 及更高版本)。框架将分配给所有驱动程序池分配的驱动程序定义的池标记。 调试器显示此标记。 有关指定池标记的详细信息,请参阅以下“备注”部分。
注解
驱动程序可以选择指定框架将分配给所有驱动程序池分配的池标记。 驱动程序通常按相反顺序指定最多四个字符的字符串,用单引号分隔(例如,“dcba”)。 标记中每个字符的 ASCII 值必须介于 0 和 127 之间。
如果 DriverPoolTag 为零,则框架将使用驱动程序内核模式服务名称的前四个字符创建默认池标记。 如果服务名称以“WDF”开头(名称不区分大小写且不包含引号),则使用接下来的四个字符。 如果可用字符少于 4 个字符,则使用“FxDr”。
若要初始化WDF_DRIVER_CONFIG结构,驱动程序必须调用 WDF_DRIVER_CONFIG_INIT。
要求
要求 | 价值 |
---|---|
最低 KMDF 版本 | 1.0 |
最低 UMDF 版本 | 2.0 |
标头 | wdfdriver.h (包括 Wdf.h) |