WdfDriverWdmGetDriverObject 函数 (wdfdriver.h)
[仅适用于 KMDF]
WdfDriverWdmGetDriverObject 方法检索指向与指定框架驱动程序对象关联的 Windows 驱动程序模型(WDM)驱动程序对象的指针。
语法
PDRIVER_OBJECT WdfDriverWdmGetDriverObject(
[in] WDFDRIVER Driver
);
参数
[in] Driver
驱动程序的框架驱动程序对象的句柄,该驱动程序从先前调用 WdfDriverCreate 或 WdfGetDriver获取。
返回值
WdfDriverWdmGetDriverObject 返回指向 DRIVER_OBJECT 结构的指针。 如果 驱动程序 句柄无效,则会发生系统 bug 检查。
注解
WdfDriverWdmGetDriverObject 方法返回的指针在删除框架驱动程序对象之前有效。 如果驱动程序为框架驱动程序对象提供 EvtCleanupCallback 函数,则指针在回调函数返回之前有效。
例子
下面的代码示例获取指向与指定框架驱动程序对象关联的 WDM 驱动程序对象的指针。
PDRIVER_OBJECT pDrvObj;
pDrvObj = WdfDriverWdmGetDriverObject(Driver);
要求
要求 | 价值 |
---|---|
目标平台 | 普遍 |
最低 KMDF 版本 | 1.0 |
标头 | wdfdriver.h (包括 Wdf.h) |
图书馆 | Wdf01000.sys(请参阅框架库版本控制。 |
IRQL | <= DISPATCH_LEVEL |
DDI 符合性规则 | DriverCreate(kmdf) |