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) |
| Library | Wdf01000.sys (请参阅框架库 Versioning.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI 符合性规则 | DriverCreate (kmdf) |