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)
图书馆 Wdf01000.sys(请参阅框架库版本控制。
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 DriverCreate(kmdf)

另请参阅

DRIVER_OBJECT

WdfDriverCreate

WdfGetDriver