WdfDriverWdmGetDriverObject 函数 (wdfdriver.h)

[仅适用于 KMDF]

WdfDriverWdmGetDriverObject 方法检索指向与指定框架驱动程序对象关联的 Windows 驱动程序模型 (WDM) 驱动程序对象的指针。

语法

PDRIVER_OBJECT WdfDriverWdmGetDriverObject(
  [in] WDFDRIVER Driver
);

参数

[in] Driver

驱动程序框架驱动程序对象的句柄,该驱动程序是从先前调用 WdfDriverCreateWdfGetDriver 中获得的

返回值

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)

另请参阅

DRIVER_OBJECT

WdfDriverCreate

WdfGetDriver