从 KMDF 版本 1.11 开始,框架支持自定义类型名称。 自定义类型名称是驱动程序可与 WDFOBJECT 实例关联的字符串。 驱动程序定义自己的自定义类型名称。 驱动程序在调用对象的创建方法后为对象指定自定义类型名称。
使用这些宏可操作自定义的类型名称。
- 若要定义自定义类型名称,请从声明全局数据的驱动程序区域(例如头文件)调用 WDF_DECLARE_CUSTOM_TYPE。
- 调用 WdfObjectAddCustomType 或 WdfObjectAddCustomTypeWithData,以将自定义类型与框架对象相关联。
- 调用 WdfObjectIsCustomType 以确定指定的对象是否为指定的自定义类型。
- 调用 WdfObjectAddCustomTypeWithData后,驱动程序稍后可以调用 WdfObjectGetCustomTypeData 来检索数据。
驱动程序可以将多个自定义类型与单个框架对象相关联。 驱动程序还可以将多个框架对象与单个自定义类型相关联。
在 KMDF 调试器扩展的输出中,自定义类型名称与其他 WDF 对象信息一起显示。
WDF_Object_Name, [custom_Type1_Name, custom_Type2_Name]