用户模式驱动程式框架
此条目没有列出任何参考或来源。 (2018年8月3日) |
用户模式驱动程式框架(英语:User-Mode Driver Framework,简称UMDF)是微软公司提出的窗口驱动程式基础(Windows Driver Foundation)的一部分,其执行于用户模式(user mode),仅能存取用户地址空间。它同时是核心模式驱动程式框架(Kernel-Mode Driver Framework,KMDF)的子集,因此UMDF所提供的函数支持少于KMDF,两者使用相同的状态机器、使用相同的I/O模型。
UMDF提供即插即用(PNP)、电源管理(Power Manager)、异步输出输入等功能,可设置I/O队列,但它的限制在于不处理中断(Interrupt)、不执行直接存储器存取(DMA),且不能使用核心模式资源如:未标签页集区(NonPaged Pool),也不完全支持同步化领域(Synchronization scope),在技术上UMDF使用COM(Component Object Model)的动态链接库(DLL)为基底技术。
COM框架
UMDF驱动程式是一个基于COM框架的动态链接档(DLL),但UMDF并不使用COM的动态时期执行函数(runtime library),单仅是借用了COM的样式。
UMDF 调用 DllGetClassObject API获取一个指针(pointer),这个指针指向一个IClassFactory的接口,并且激活 CreateInstance 这个属于IClassFactory 接口的函数来产生一个驱动程式的存储器实体(instance)。DLL 照例提供一些函数可以让COM 使用基于IWDFDriver的物件:
- DllCanUnloadNow
- DllGetClassObject
- DllRegisterServer
- DllUnregisterServer
进入点(entry point)
UMDF 驱动程式是一个动态链接库,执行的时候如同一个行程内(in-process)的COM伺服器,其代码中包括了DllMain,这是著名的DLL档的进入点(entry point)。
BOOL WINAPI DllMain( HINSTANCE ModuleHandle, DWORD Reason, PVOID /* Reserved */) { if (DLL_PROCESS_ATTACH == Reason) { WPP_INIT_TRACING(MYDRIVER_TRACING_ID); g_ModuleHandle = ModuleHandle; } else if (DLL_PROCESS_DETACH == Reason) { WPP_CLEANUP(); } return TRUE; };
UMDF接口
- IWDFObject: 定义基本的 WDF 物件类型(WDF object)
- IWDFDriver: 代表驱动程式物件(driver object)
- IWDFDevice: 代表设备物件(device object)
- IWDF�:代表文件物件(file object)
- IWDFIoQueue: 代表 I/O 要求的队列(IO Request Queue)
- IWDFIoRequest: I/O 要求描述(IO Request Description)
- IWDFIoTarget: 代表 I/O 要求的目标驱动程式(IO Target)
- IWDFMemory: 提供存取存储器区域(Memory)